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About This Manual 



Purpose 

This manual brings together a set of various software utilities that are used to monitor, 
analyze, and control the computer system. 

Scope 

The utilities described in this manual are for A Series systems. These utilities perform 
such functions as recording system events, testing or analyzing data communications 
(data comm) facilities, initiating and analyzing memory dumps, and managing system 
resources. 

Information on memory dump procedures can be found in the A Series System 
Operations Guide. 

Audience 

This manual is a reference manual intended primarily for use by systems support 
personnel. It is also useful to operations personnel, programmers, and managers. 

Prerequisites 

The users of this manual should know the information in both the A Series System 
Operations Guide and the A Series System Administration Guide. 

How to Use This Manual 

The majority of the sections of this manual discuss system utilities used for system 
monitoring. Each section is named after the utility it documents. A tab marks the 
beginning of each section. 

Unless stated otherwise, all books referred to are for Unisys A Series systems. 

Appendix A describes how to use railroad syntax diagrams that appear in Unisys 
manuals. 
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Organization 

This manual comprises the following sections and appendix. In addition, a glossary, a 
bibliography, and an index appear at the end of the manual. 

Section 1. BARS 

This section describes the BARS utility program, which is used to monitor the 
performance of the system by sampling various system utilization information. 

Section 2. DCAUDITOR 

This section describes the DCAUDITOR program that performs analysis of an 
NSPAUDIT file produced by the data comm subsystem procedures of the operating 
system. 

Section 3. DCSTATUS 

This section describes the DCSTATUS utility, which makes use of the 
DCSYSTEMTABLES installation intrinsic to produce an analysis of the data comm 
tables maintained by the operating system and the network support processor (NSP) 
data comm subsystem. 

Section 4. DUMPANALYZER 

This section describes the DUMPANALYZER utility, which can be invoked with various 
options to analyze a memory dump. 

Section 5. HARDCOPY and PRINTCOPY 

This section describes the HARDCOPY and PRINTCOPY utility programs, which 
provide a way to capture system input commands and system messages within a disk 
file and print the contents of that file. 

Section 6. HDU System Balancing 

This section describes the functions that are used to monitor and change system 
utilization for the A 12 and A 15 systems. 

Section 7. LOGANALYZER 

This section describes the LOGANALYZER utility program, which produces reports of 
SUMLOG entries based on specified parameters. 

Section 8. LOGGER 

This section describes the LOGGER utility program, which produces reports that aid 
in the analysis of system performance and utilization. 
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Section 9. Peripheral Test Driver (PTD) 

This section describes the peripheral test driver (PTD) program that interprets 
op-codes that are found in test case S-code files created to test peripheral equipment on 
a system. 

Section 10. REPORT LOG ENTRIES 

This section describes the exported master control program (MCP) procedure 
REPORT_LOG_ENTEIES, which DCALGOL programs can use to monitor the logging 
of selected types of log entries. 

Section 1 1 . STATUS_CHANGE_RE QUEST 

This section describes the exported MCP procedure STATUS_CHANGE_REQUEST, 
which DCALGOL programs can use to monitor changes in process status and system 
initialization status. 

Section 12. SUMLOG 

This section describes the system summary log file, SUMLOG, which is used on 
A Series systems to record information concerning jobs previously run, past operating 
system activity, and other related information concerning the past status of the 
machine environment. 

Section 13. System Stability Reporting 

This section explains how to use the system stability reporting (SSR) interactive 
support tool (ISTUTILITY) to record information about system disruptions. 

Appendix A. Understanding Railroad Diagrams 

This appendix explains how to use the railroad syntax diagrams that appear in Unisys 
manuals. 

Related Product Information 

A Series System Administration Guide (8600 0437) 

This guide provides the reader with information required to make decisions about 
system configuration* peripheral configuration, file management, resource use, and 
other matters related to system administration. This guide is written for users with 
some, little, or no A Series experience who are responsible for making decisions about 
system administration. 

A Series System Commands Operations Reference Manual (8600 0395) 

This manual gives a complete description of the system commands used to control 
system resources and work flow. This manual is written for systems operators and 
administrators. 
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A Series System Operations Guide (8600 0387) 

This guide describes the basic concepts and procedures required to operate Micro A 
through A 6 systems and, more generally, all A Series systems. This guide is written for 
A Series operators, especially those with little or no experience. 

BNA Version 2 Network Encoded Messages Programming Reference Manual, 
Volumes 1 and 2 (3787 5127), (3787 7598), and (3787 7529) 

This manual provides in reference format the encoded formats of BNA, 
CP 2000/CPDLP/MACP100 SNA PUT2, CP 2000 SNA PUT5, NCF, OSI, and TCP/IP 
Operations Interface Messages (OIMs), depending on the version of BNA being 
documented. The part number for the 1.2 version of the manual is 3787 7529, the part 
number for the 3.0 version of the manual is 3787 5127, and the part number for the 3.1 
version of the manual is 3787 7598. 
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Section 1 
BARS 



This section describes the BARS utility program, which provides a way to monitor 
system performance by sampling various system utilization information. 

General Information 

The BARS utility program monitors the performance of the system and displays it in 
the form of numeric values and bar graphs. Various system utilization information 
is sampled and displayed dynamically on screen-type terminals. The information 
displayed and the format of the screen are user-controllable. 

A sample is taken and the display updated every "cycle" seconds. The values displayed 
are the average of the samples taken over the last "period" seconds. The default value 
for the cycle is five seconds. The default value for the period is 15 seconds. 

The numeric values represent either actual values (for example, the number of 
core-to-core moves) or percentages (for example, the percent of available processor 
time). 

The plus signs (+) and minus signs (-) that follow numeric values indicate that the 
values have increased or decreased, respectively, since the last cycle, even if the actual 
values or bar graphics have not visibly changed (that is, a fractional change, which 
cannot be displayed, has occurred). 

Values are also represented by bars on the screen. The format of each bar consists of 
number signs (#), followed by (depending on the system) capital Xs, or small, solid 
rectangles (the DEL character), followed by periods (.), where the number signs extend 
to the minimum value, the Xs extend to the current value, and the periods extend to 
the maximum value. The minimum and maximum values are based on the values that 
existed when the program was initiated or updated from the terminal by the user. 

When the user enters the following command, the program executes a LOAD 
DEFAULT command, which displays the default screen for that system: 

E $SYSTEM/BARS 

The program is initialized to a different display if the file DISPLAY is label equated to a 
saved file. For example, 

E $SYSTEM/BARS; FILE DISPLAY (TITLE = MY/SCREEN) 
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If the file MONITOR is label equated, the program writes the raw performance data to 
that file as it is received from the operating system. For example, 

RUN $SYSTEM/BARS; FILE M0NIT0R(TITLE = DEFAULT) 



BARS Commands 

The following commands can be used as input to the BARS utility program. 
<bars commands> 

<bye command> 1 1 

— <cycle command> 

— <di splay command> 

— <help command> 

— <load command^ 

— <newdi splay command>— 

— <pack command> 

— <period command> 

— <save command> 

— <words command> 



BYE Command 



The BYE command ends the program. 
<bye command> 

— BYE 



CYCLE Command 



The CYCLE command controls the sampling and display update interval. 
<cycle command> 

— CYCLE — <integer> 1 

Explanation 

The variable <integer> represents the interval in seconds. 



DISPLAY Command 



The DISPLAY command displays the NEWDISPLAY input required for a specified 
display screen. 

<di splay command> 
— DISPLAY 



(- DEFAULT - 
<file names 
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The following text describes the meaning of each option: 



DISPLAY Entering DISPLAY causes the NEWDISPLAY input required for the 

current screen (either a user-specified screen or the default screen) to be 
displayed. 



DEFAULT The DEFAULT option displays the NEWDISPLAY input for the default 

screen for that system. 



<file name> The <file name> displays the NEWDISPLAY input for the screen saved 

in the specified file. 



Example 



The following command causes the NEWDISPLAY input for the screen saved in the file 
called X/Y to be displayed: 

DISPLAY X/Y ON P 



The HELP command (or TEACH command) displays information that helps the user 
in using the BAES utility. 

<he1p command> 



The LOAD command loads a previously generated screen as the new screen. The 
maximums, minimums, and averages for the system utilization information are 
reinitialized. 

<load command> 

— LOAD -, 1 1 



- DEFAULT 

— <file name>— ' 

Entering LOAD causes the current display to be loaded as the new screen. Essentially, 
this means that the current screen does not change, though the maximum, minimum, 
and average values displayed are reinitialized. 

The following text describes the meaning of each option: 

DEFAULT The DEFAULT option loads the default screen for that system. 

<file name> The <file name> is the name of the file that contains the screen 



HELP 



Command 




LOAD 



Command 




information to be loaded. 
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The NEWDISPLAY command generates a new screen that is used to display system 
utilization information. 

<newdi splay command> 

— NEWDISPLAY — — — 1 

Explanation 

In order to use the NEWDISPLAY command to modify an existing screen, which is 
the typical case, the user enters DISPLAY followed (optionally) by one of its options 
and is presented with a screen in a form suitable for modification and transmission as 
NEWDISPLAY input. 

After the DISPLAY command is entered, the keyword NEWDISPLAY appears on a 
line by itself in the upper left-hand corner of the screen. The NEWDISPLAY line is 
followed by the screen keywords, a group of Ns, and a group of Bs. The Ns are used to 
designate the field for displaying the numeric value of the keyword item. The Bs are 
used to designate the bar graph field for that item. 

The user can then modify the screen by adding, deleting, or rearranging the keywords, 
Ns, and Bs. Optional text placed in single quotation marks (') can also be added. The 
screen is then transmitted by placing the cursor at the upper left-hand corner of the 
screen. After the screen is transmitted, it is presented as a dynamic display, which can 
be saved by using the SAVE command. 

Rather than modifying an existing screen, the user can also use the NEWDISPLAY 
command to design a new one. The keyword NEWDISPLAY must be entered in the 
upper left-hand corner of the screen and any other information on that line must be 
deleted. Then any keywords can be entered on the screen, followed by optional Ns and 
Bs. Optional text placed in single quotation marks can also be added. 

As in the case above, after the screen is transmitted, it is presented as a dynamic 
display, which can be saved by using the SAVE command. 

In order for NEWDISPLAY input to be accepted, the following requirements must be 
met: 

• The keyword NEWDISPLAY must appear on a line by itself in the upper left-hand 
corner of the screen. 

• The keywords must be valid keywords (available through the WORDS command). 

• The entire screen must be transmitted by placing the cursor at the upper left-hand 
corner of the screen. 

• Optional comments or text must be placed in single quotation marks (')• 
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Example 

IDLE NN BBBBBBBB 
•on PACK, system XYZ' 
The preceding code produces a display like the following: 
Idle 45 ###XX... 
on PACK, system XYZ 



PACK Command 



The PACK command displays the unit numbers, family indexes, and labels of the packs 
currently on line. On A Series I/O processor (IOP) systems, the channel or base unit 
identification of the pack string is also displayed. PK and PERPK are synonyms for 
PACK. 

<pack command> 



TPACK - 
PK — 
PERPK 



PERIOD Command 



The PERIOD command changes the value of the period. If PERIOD is less than 
CYCLE, no averaging of system utilization information is done; that is, the exact value 
of each sample is displayed. 

<period command> 

_ PERIOD 1 

Explanation 

Several values are computed as running averages using the following formula: 

NEWAVERAGE := ((OLDAVERAGE * (PERIOD - CYCLE)) + (NEWVALUE * CYCLE)) 
/ PERIOD 

The variable < integer > represents the period in seconds. 



SAVE Command 



The SAVE command saves the current display in a specified file. 

<save command> 
— SAVE — <file name>- 



L- ON — <family name>-J 
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( 

Example 

The following command saves the current display in the specified file (namely, X/Y): 
SAVE X/Y ON P 

WORDS Command 

The WORDS command displays the allowed keywords for the NEWDISPLAY input, 
plus a short description of the meaning of each. 

<words command> 

_ WORDS — 1 

Keywords 

The following table includes all allowed keywords for the BARS utility: 



Keyword Description 

LASTCYCLE Number of seconds since last display 

AVGCYCLE Average number of seconds between displays 

IDLE Percentage of available processor time spent idling 

MCP Percentage of available processor time spent on nonvisible user or 

operating system processes 

USER Percentage of available processor time spent on visible user or operating 

system processes 

OVHD Percentage of available processor time spent stack switching or stack 

searching, and lOfinish time 

PBIT Percentage of total available processor time spent performing presence 

bit operations 

INIT Percentage of total available processor time spent doing initial presence 

bit operations 

FREE Percentage of total available processor time spent performing presence 

bit operations after resumption 

SAVE Save memory 

OLAY Overlayable memory 

AVAIL Available memory 

OVRFL Overlay-file words for overlayable memory 

CCACT Number of core-to-core moves 

COACT Number of overlays 

OCACT Number of overlay-file presence bit operations 

PCACT Number of code file presence bit operations 

continued 
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Keyword 


Description 


CLACT 


Number of core-to-limbo overlays 


CCWRD 


Number of words moved core-to-core 


COWRD 


Number of words overlayed 


OCWRD 


Number of words read from overlay files 


PCWRD 


Number of words read from code files 


CLWRD 


Number of read-only words overlayed 


TRFC 


Percentage of time when overlay I/O in process 


MIX 


Number of tasks in mix 


STED 


Number of tasks suspended by the system 


READY 


Number of tasks waiting for processors 


SCHED 


Number of scheduled tasks 



In addition, a keyword is shown for each online labeled pack, which allows the number 
of I/O operations waiting for that unit to be displayed. 



MONITOR File Format 

If you give the file MONITOR a label equation when you run the BARS program, the 
resulting performance data is written to that file as the data is received from the 
operating system. You can analyze the resulting captured performance data by using 
the MONITOR file information that follows. 

The MONITOR file has the following format: 

Record 1 
Record 2 
Record 3 
Record 1 
Record 2 
Record 3 



Each record is 180 words long. The record contents are displayed below: 

Record Number Information 

1 Operational information 

2 Utilization times and counts information 

3 Queue information 

The contents of MONITOR records 1, 2, and 3 are detailed below 
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MONITOR Record 1 (Operational Information) 

You can obtain information in this record by making a type 2 SYSTEMSTATUS call. 
Refer to the A Series SYSTEMSTATUS Programming Reference Manual for more 
information. 

The following table shows the structure of record 1: 

Corresponding Type 2 



Word 


Data Type 


Name 


SY! 


0 


Integer 


MIXCOUNT 


6 


1 


Integer 


AVAILCORE 


9 


2 


Integer 


OLAYCORE 


10 


3 


Integer 


SAVECORE 


11 


4 


Real 


CCOLAY 


15 


5 


Real 


CCWORDS 


15 


6 


Real 


COOLAY 


17 


7 


Real 


COWORDS 


18 


8 


Real 


OCOLAY 


19 


9 


Real 


OCWORDS 


20 


10 


Real 


PCOLAY 


21 


11 


Real 


PCWORDS 


22 


12 


Real 


CLOLAY 


23 


13 


Real 


CLWORDS 


24 


14 


Integer 


OLAYCHANNELS 


27 


15 


Integer 


SUSPENDEES 


29 


16 


Integer 


BATCHOLAYDISKSIZE 


41 



MONITOR Record 2 (Utilization Times and Counts Information) 

You can obtain the information in this record by making a type 7, subtype 1 
SYSTEMSTATUS call. Refer to the SYSTEMSTATUS Reference Manual for more 
information. 

The following table shows the structure of record 2: 
Word Data Type Contents 

0 Integer Writes the current time to the MONITOR file in 

increments of 2.4 microseconds. 

1-39 Integer Equivalent to words 0 through 38 of a type 7, 

subtype 1 SYSTEMSTATUS CALL 

40 Integer Total time spent by all processors in operating 

system tasks 



continued 
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continued 

Word Data Type Contents 

41 Integer Total time spent by all processors in user tasks 

MONITOR Record 3 (Queue Information) 

You can obtain the information in this record by making a type 23 SYSTEMSTATUS 
call. Refer to the SYSTEMSTATUS Reference Manual for more information. 

The structure of record 3 is equivalent to the structure of the type 23 SYSTEMSTATUS 
call. 
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DCAUDITOR is a program that performs analysis of an NSPAUDIT file produced by 
the data comm subsystem procedures of the operating system. 

The user can identify the items to be audited by using the ID (Initialize Data Comm) 
system command audit options. When one more more of the audit options is set, the 
system takes the following actions: 

• Begins writing the requested types of audit information to a file called 
NSPAUDIT/DCCONTROL/<NSP unit ID> 

• The next time data comm is initialized, writes data comm initialization information 
to a file called NSPAUDIT/DCINITIAL/<NSP unit ID> 

DCAUDITOR performs detailed analysis for NSP requests and results; however, only 
the TYPE/CLASS field is analyzed for DCWRETE formatted requests and results. 

DCAUDITOR RUN Statement 

The run statement of DCAUDITOR is as follows: 

RUN *SYSTEM/DCAUDITOR("<DCAUDITOR options>"); VALUE = <nnn> 

In this statement, < DCAUDITOR options > is a string of options separated by spaces 
and <nnn> is the unit number of the NSP whose audit file is to be analyzed. 

Options 

<DCAUDITOR options> 



- DCINITIAL 

- DCCONTROL 

— <backspace count> 

- LINE S — <range> 

- LSN S — <range> 

i- STATION S — <range>-' 

<backspace count> 

— <i nteger> 

<range> 

— <integer-l>— i 

I— <integer-2: 



8600 0478-100 



2-1 



DCAUDITOR 



The following text describes the meaning of each option: 



DCINITIALand 
DCCONTROL 



< backspace 
count > 



LINES 



LSNS 



STATIONS 



The DCINITIAL and DCCONTROL options specify which file is to be 
analyzed. DCINITIAL selects the NSPAUDIT file created during NSP 
initialization, and DCCONTROL selects the NSPAUDIT file created after 
the NSP has initialized. 

If these options are not specified, the file that is label-equated to 
SCAUDITF is analyzed. 

The <backspace count> option restricts the analysis to <backspace 
count > records of the NSPAUDIT file. Valid integers are I through 
1048575. 

The LINES option allows the selective analysis of NSP requests and 
results that pertain to a range of line numbers. A line number is 
assigned by the Network Definition Language II (NDLII) compiler and is 
the ordinal number of the line in the SOURCENDLII, starting at 1. 

If this option is used, no DCWRITE requests and results are displayed. 

The LSNS option allows the selective analysis of NSP requests and 
results that pertain to a range of logical station numbers. A logical 
station number is assigned by the operating system and is the ordinal 
number of the station in the SOURCENDLII, starting at 2. 

If this option is used, no DCWRITE requests and results are displayed. 

The STATIONS option allows a selective analysis of NSP requests and 
results that pertain to a range of station numbers. A station number is 
assigned by the NDLII compiler and is the ordinal number of the station 
in the SOURCENDLII, starting at 1. 



If this option is used, no DCWRITE requests and results are displayed. 



Sample Report 

Figure 2-1 is an example of output from the DCCONTROL command. Messages for 
DCWRITE formatted requests and results are printed in hexadecimal (hex) characters. 
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00 

cn 
o 
o 

O DCAUOI TOR INPUT: OCCONTROL 

5 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

00 X OCAUOITOR LEVEL IS: 04.031.1 X 

T X MCP NAME WAS: *SYSTEM/MCP/39030E * 

h- X MCP LEVEL WAS: 39.031.3933 X 

O X MACHINE TYPE WAS: A15 , . . X 

O * THE NSP FIRMWARE LEVELS ARE: (PROM = 28.0 , (RAM = 28.5) X 

X OATACOM FILE PREFIX WAS: SJA15C 

X THIS AUDIT TRAIL WAS PROOUCEO ON THURSOAY , JULY 12. 1990 AT 12:58:28 X 

X THIS AUOIT TRAIL WAS PROOUCEO FROM THE FOLLOWING F I LE : *NSPAUDI T/DCC0NTROL/01O7 ON DISK X 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

********************************************************************* 
##### DATACOM DUMP REQUESTED ##### 

************************************************************************************************************************************ 



a 



DCPREQUEST iiiti IOLENGTH = 14 WORDS TIMESTAMP = 12:58:29.07 
>$$$ STATION QUEUED FOR LSN 227 $$$$$ 
)CP MESSAGE TYPE = OUTPUT REQUEST 

070000800000 000000000000 OA0029000000 000000000000 000000210000 000000000000 105940220100 710024030500 OFO00607OE01 



jg- 0B010504D401 0E0006070E01 0F0006070E01 110006070EOO 000000000000 

(TO ************************************************************************************************************************************ 
C 



##### DCPREQUEST ####> IOLENGTH = 14 WORDS TIMESTAMP = 12:58:29.08 
MM STATION QUEUED FOR LSN 227 $$$$$ 



IS> DCP MESSAGE TYPE = OUTPUT REQUEST 
I 070000800000 000000000000 0A0029000000 000000000000 000000210000 000000000000 106164220100 730024030500 DF0006070E01 

^ 0B010504D401 0EOOO607OEO1 0F0006070E01 110006070E00 000000000000 

• ************************************************************************************************************************************ 



JJJJJ DCPREQUEST ##### . IOLENGTH . ■ 6 WORDS TIMESTAMP = 12:58:30.48 



PENDING QUEUEO FOR LSN 227 $$$$$ 

DCP MESSAGE TYPE = OUTPUT REQUEST 



Ouv.r lujjnut i iru - uuirui nLuutji 
070000800000 000000000000 0A0029000000 000000000000 000000210000 000000000000 

w ************************************************************************************************************************************ 

2 ff ## f SCREQUEST iiiii IOLENGTH = 84 BYTES TIMESTAMP = 12:58:30.50 

2 SUii S I DELINKED TO THE ABOVE REQUEST IN PENDING Q $$$$$ 

H REQUEST NUMBER (DOUBLE) VALUE « 3 16 587 98 ( 0 1 E3 1 32 E ) 

O 



REQUEST TYPE ( ENUMERATION) VALUE = 23(17]: OUTPUT 
STATION NUMBER (INTEGER) VALUE * 482(01E2) 
TEXT SIZE (INTEGER) VALUE = 41(0029) , , 



- OUTPUT STATUS REQUIRED (BOOLEAN) VALUE = TRUE 01 

O PRIORITY (BYTE) VALUE = 0(00) *?" , , 

H SUPPRESS, ED IT (BOOLEAN) VALUE = FALSE 00 

a SIGNAL BYTE ARRAY) LENGTH = 3 BYTES. 

5 (0) 00 00 00 ??? 



_ REPLY BYTE ARRAY] LENGTH = 14 BYTES. 

O , (0) 00 00 00 00 00 OC 3A 19 15 00 00 00 OA 00 

£ TEXT TEXT ARRAY) LENGTH * 41 BYTES. 

■a 0000) 10 62 4C 22 01 00 09 00 24 03 05 00 OF 00 06 07 OE 01 OB 

C 0020 05 04 04 01 OE 00 06 07 OE 01 OF 00 06 07 OE 01 11 00 06 

[0040] OE 
t******** 



************************************************************************************************************************************ 

IOLENGTH = 6 WORDS TIMESTAMP - 12:58:30.52 



##### DCPREQUEST ##### IOLENGTt 
$$$$$ PENDING QUEUED FOR LSN 227 U 

DCP HESSJgj JJPj j OjjTjjjT gjjUJjf 000000000000 0 000 0000 0000000 0 

************************** ******** 



o 
> 
c 
a 

30 
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Section 3 
DCSTATUS 



DCSTATUS is a DCALGOL program that makes use of the DCSYSTEMTABLES 
installation intrinsic to produce run-time "snapshots" of the data comm tables 
maintained by the operating system and the data comm subsystem. (For further 
information about the DCSYSTEMTABLES installation intrinsic, refer to the A Series 
DCALGOL Programming Reference Manual.) 

DCSTATUS analyzes elements of the data comm subsystem for the A Series systems. 

No attempt is made in this section to interpret the results generated by the DCSTATUS 
program, because understanding these results requires an understanding of Network 
Definition Language II (NDLII), as well as a general familiarity with the network 
support processor (NSP). 



Execution 

The DCSTATUS program can be invoked as follows: 

• Through the Command and Edit (CANDE) DCSTATUS command 

• Through the DIAGNOSTICMCS DP command 

• Through a CANDE or Work Flow Language (WFL) R UN statement 



CANDE DCSTATUS Command 

The CANDE DCSTATUS command can be entered from a remote terminal to execute 
DCSTATUS and produce a run-time analysis of the current state of the data comm 
subsystem. 

<CANDE dcstatus command> 
— DCSTATUS 



I— <dcstatus option list>— I 



— <modifier>- 



The following text describes the meaning of each variable: 

<dcstatus option The <dcstatus option list> must consist of a string of standard options 
list > allowed by DCSTATUS. If <dcstatus option list > is not specified, the 

default is the STATION option with the <lsn> specification set to the 
user's logical station number (LSN). The output is directed to the user's 
terminal. (Refer to "DCSTATUS Options" in this section for a complete 
description of each option.) 

Note: The ALL, NSI} and LSP options produce voluminous 
output 

continued 
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continued 



<modifier> For a definition of <modifier> , refer to the A Series CANDE 

Operations Reference Manual. 

Examples 

DC 

#RUNNING 3854 
STATION 13 

SYSTEM/DCSTATUS (3.7.140) DATE : 08/14/78 TIME : 1540:08 

DCPREFIX: *SYSTEM 

STATION 13 

DCC STATION TABLE 

ENABLED : READY : ATTACHED : 

MCS = 1: LSN = 13 : WIDTH = 80 

STATION REMOTE TYPE = 0 : RETRY COUNT =0 : NIF INDEX = 262 

PRIMARY Q = 8, CURRENT Q = 8,STN Q = 0 

DLS : 0,2,2 ATTACHED TO FILE 1 REL STN NO = 1 

NORMAL TERMINATION 



For more information, see "DCSTATUS Options" in this section. 

DIAGNOSTICMCS DP Command 

The DIAGNOSTICMCS DP command might be entered from a remote terminal to 
initiate DCSTATUS and produce a run-time analysis of the current state of the data 
comm subsystem. For information beyond that given here, refer to the A Series 
DiagnosticMCS Reference Manual. 

<diagnosti ernes dp command> 



? — DP -i i-t- REMOTE ■ 1 <dcstatus option>- 



-i 1 — i — Rtnui 

L ON — <family name>-J L SITE 

The following text describes the meaning of each option: 

ON <family The ON <family name> option might be used to specify the family on 

name> which DCSTATUS resides. 

REMOTE Specifying REMOTE causes DCSTATUS output to be sent to the remote 

station initiating the DP. 

SITE Specifying SITE causes DCSTATUS output to be directed to the printer. 

<dcstatus Refer to "DCSTATUS Options" in this section for a complete description 

option > of each option. 
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Examples 

?DP REMOTE (STATION 5) 

## OK ## 

## FILE OPEN ## 

STATION 5 

SYSTEM/DCSTATUS (3.7.140) DATE : 08/14/86 TIME : 0623:28 

DCPREFIX : *SYSTEM 

STATION 5 

DCC STATION TABLE 

ENABLED : READY : ATTACHED : 

MCS = 1: LSN = 13 : WIDTH = 80 

STATION REMOTE TYPE = 0 : RETRY COUNT =0 : NIF INDEX = 262 

PRIMARY Q = 8, CURRENT Q = 8,STN Q = 0 

DLS : 0,2,2 ATTACHED TO FILE 1 REL STN NO = 1 

NORMAL TERMINATION 

## FILE CLOSE ## 



CANDE and WFL Run Statements 

Either of the following CANDE statements can be entered from a remote terminal to 
initiate DCSTATUS: 

RUN *SYSTEM/DCSTATUS ("<dcstatus option list>") 

EXECUTE *SYSTEM/DCSTATUS ("<dcstatus option list>") 

The following WFL job deck can be entered from an operator display terminal (ODT) to 
initiate DCSTATUS: 

BEGIN JOB; 

RUN *SYSTEM/DCSTATUS ("<dcstatus option list>"); 
END JOB 

Refer to "DCSTATUS Options" in this section for a complete description of each 
allowable DCSTATUS option. 

The [<task identifier>] and <task equation list> specifications can be added to the 
WFL RUN statement as desired. (Refer to the A Series Work Flow Language (WFL) 
Programming Reference Manual for more information about the RUN statement.) 

When either the CANDE or WFL RUN statement is used, DCSTATUS output is sent to 
the line printer unless LINE is file-equated to KIND = REMOTE . 

For more information, see "DCSTATUS Options" in this section. 
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DCSTATUS Options 

The <dcstatus option list> specifies those elements of the data comm subsystem 
that are to be analyzed. These options are shown in the following diagram in this 
subsection. The following options are arranged hierarchically so that the earlier 
elements listed include all those that follow: ALL, NS£ LSP, and STATION. In other 
words, each higher-order item in the hierarchy (they are listed from highest to lowest) 
is inclusive of all lower-order items. For example, if LSP is specified, the analysis is 
performed on all lines and stations on that line support processor (LSP). However, the 
options TERMINAL, TABLES, NETWORK, GRAPH, and FILE do not fit into this 
hierarchy. A full explanation of each option is given in the text that follows the syntax 
for <dcstatus option list>. 

The internal file name for the output file is LINE. When the WFL RUN statement or 
the CANDE RUN statement is used to initiate DCSTATUS, output is sent to the line 
printer by default. When the CANDE DCSTATUS command or the DIAGNOSTICMCS 
DP command is used, the output is sent to a remote terminal by default. The output 
format is modified to fit a 72-character line width. The file LINE can be file-equated in 
any of the above cases if an output device different from the default is wished. 

The DCSYSTEMTABLES intrinsic does not lock the various tables that it accesses. 
Therefore, the contents of the tables might change while the intrinsic is accessing 
them. In addition, more than one call on the DCSYSTEMTABLES intrinsic is made 
to obtain the contents of all the various data comm tables. If the data comm tables 
maintained by the operating system change between calls, the results produced by 
DCSTATUS can appear internally inconsistent. 

By using the FILE statement, analysis can be performed on DATACOMINFO files 
other than the currently active DATACOMINFO file. The following are the only 
allowable options for inactive DATACOMINFO files: 

• NSP<unitID> NDL or NSPNDL 

• STATION <station number> NDL or STATION NDL 

• TERMINAL 

• GRAPH 

• NETWORK 
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<dcstatus option> 



ALL 

NSP -j-<unit 

-<unit ID> — ' 



it ID^ 



NDL 



LSP — <unit ID> 



:zr 



STATION -i r-i 

L-<LSN>— ' L NDL 
TERMINAL -, 



-odapter number^ 



'— <LSN>-- J — NDL 

- TERMINAL -. 

I— <termina1 number>- 
\- TABLES 



- GRAPH n 

<DC file prefix> 

- NETWORK -, 



— "»u^ iiic pre i ia-" 

- NETWORK -, 

L— <DC file prefix>- 
L FILE -, 



FILE -, 

"-<DC file prefix> 



<DC file prefix> 



■<i denti f i er>— i r- 

■— ON — <family name>— ' 



The following text describes the meaning of each option: 



ALL 



NSP 



LSP 



STATION 



TERMINAL 



TABLES 
GRAPH 



Produces a complete analysis of the data comm network. Analysis of all 
NSP, LSP, and station tables, together with an analysis of the NDLII for 
each station and terminal, is performed. 

Produces an analysis of line support processors (LSPs), lines, and 
stations on all network support processors (NSPs), or on a specific NSR 
Use of the NDL option causes reporting to be based on the information 
contained in the DATACOM INFO file instead of that contained in the 
current data comm tables. 

Produces an analysis of the lines and stations on the designated line 
support processor (LSP). The odapter number> option produces an 
analysis of the designated adapter on the line and its stations. 

Produces a station analysis. If no <lsn> is specified, all stations are 
analyzed. The normal sources of information for the STATION option are 
the operating system data comm tables. If the NDL option is specified, 
the source of information is the DATACOMINFO file. 

Produces a listing of the NDLII specifications of all terminals or of the 
designated terminal. If no <terminal number> is specified, all terminals 
are analyzed; otherwise, the specified terminal is analyzed. Terminals 
are numbered in the sequence in which they appear in the NDLII 
terminal definitions. 

Produces a raw hexadecimal dump of the data communications 
controller (DCC) tables and the NSP line and station tables. 

Produces a graph of the data comm network showing the relationship 
between the NSPs, LSPs, lines (names and addresses), and stations 
(names and LSNs). Because the graph information is obtained from the 
network definition files specified by the <DC file prefix >, the GRAPH 
option can be used whether data comm is running or not. If the <DC 
file prefix > is not specified, the one currently being used by the system 
is GRAPHed. 

continued 
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NETWORK Produces a brief tabular network configuration report. Information in the 

report includes NSR LSP, line/adapter, station, terminal, and MCS data. 
Because the network information is obtained from the network definition 
files specified by the < DC file prefix >, the NETWORK option can be 
used whether data comm is running or not. If the <DC file prefix> is 
not specified, the one currently being used by the system is analyzed. 

FILE When the <DC file prefix> is specified, limited analysis can be 

performed on any inactive DATACOMINFOfile. If the <DC file prefix> is 
not specified, the one currently being used by the system is used. For 
example, suppose DCSTATUS is supplied with the following <dcstatus 
option list>: 

("FILE A/B; NETWORK; GRAPH; FILE; NETWORK; GRAPH") 

The first NETWORK and GRAPH reports are generated using 
A/B/DATACOMINFO; the remaining reports use the DATACOMINFO files 
that are currently being used by the system. 

Examples 

The following are introductions to the examples that appear on the following pages: 

1. Figure 3-1 shows a portion of what DCSTATUS would produce on the line 
printer using the NETWORK option. A table of information about the network 
is given that includes the headings NSP#, LSP#, LINE#, STATION type, 
LSN#, adapter#, Receive Address (RA), Transmit Address (TA), terminal type, 
synchronous or asynchronous mode, bits-per-second transmitted, class declared 
for the terminal in the DATACOMINFO file and the name of the message control 
system (MCS) in use. 

2. Figure 3-2 shows a portion of what would be produced on the terminal when the 
GRAPH option is specified. A chart of the data comm network is given showing 
the NSI* LSPs, designated lines, and line stations. The chart includes the type of 
terminal associated with each line station along with the logical station number 
(LSN) for each terminal. Other information such as line adapter numbers is also 
given. 

3. Figure 3-3 shows the output from the DCSTATUS option TERMINAL on 
the line printer or at a remote terminal. The DATACOMINFO settings for 
the terminals are given in categories such as MAXINPUT, MAXOUTPUT, 
RECEIVE-ADDRESS-SIZE, and so forth. 

4. Figure 3-4 shows the output from the DCSTATUS option STATION on a line 
printer. The station name and terminal name are given along with information 
about the DCC station table. 
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****************************************************************** 

* DATACOMM NETWORK SUMMARY * 

* OCPREFIX: SJA15C . 

* * 

* OATE : 08/06/90 TIME : 13:05:32 * 
****************************************************************** 

****** *********** ******** 21**** ********£********* ********** 

107: 116:00 0:000:000 X25TOC0N 484 ?? ?? X25TERMINAL X25071600 119 BIT 9600 F SYSTEM/BNAMCS 

107: 116:01 0:001:000 8DLCMPCP061 483 ?? ?? OCDLP BDLCTERM BNA071601 118 BIT 9600 F SYSTEM/BNAMCS 



NSP. 
****** 



LSP:AD D: L 
************* 



STATION LS 

* ******************** ********* 



>N RA TA 



TERMINAL 
******** 



121:00 
121:00 
121:00 
121:00 
121:00 
121:00 
121:00 
121:00 
121:01 
121:02 
121:03 
.121:03 
121:03 
121:03 
121:03 
121:03 
121:03 



000:000 
000:001 
000:002 
000:003 
000:004 
000:005 
000:006 
000:007 
001:000 
002:000 
003:000 
003:001 
003:002 
003:003 
003:004 
003:005 
003:006 



TB132 
TB240 
TB243 
TB245 
TB247 
T8242 
TB248 
TB250 

DCDLPBSC2780STA 

PB100S10 

TB234 

TB239 

TB252 

TB254 

TB255 

TB263S10 

TB268 



485 HP HP 

486 KH KH 

487 KK KK 

488 KM KM 

489 KO KO 

490 KJ KJ 

491 KP KP 

492 KR KR 
152 ?? ?? 

493 ?? ?? 

494 KB KB 

495 KG KG 

496 KT KT 

497 KV KV 

498 KW KW 

499 Zl ZI 

500 LJ LJ 



********** 

T019200 
T019200 
TD19200 
T019200 
T019200 
TD19200 
TD19200 
TD19200 

B 1 SYNC2780TERM 

DCDLP AP9208TERM 

TD19200 

T019200 

TD19Z00 

TD19200 

TD19200 

T019200 

T019200 



LINEIO 
************ 

T0102100 

TD102100 

TD102100 

TD102100 

T0102100 

TD102100 

TD102100 

TD102100 

DCDLP BSCLI 

AP102T02 

TD102103 

TD102103 

TD102103 

T0102103 

TD102103 

T0102103 

TD102103 



******** 



********* 



NE 



120 ASYN 
120 ASYN 
120 ASYN 
120 ASYN 
120 ASYN 
120 ASYN 
120 ASYN 



BPS 
******* 

19200 
19200 

11188 



SW MCS 
******* 



************************** 




122 ASYN 
122 ASYN 



SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/CANDE 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 

SYSTEM/COMS 



NSP: LSP:AO 0: L : S STATION LSN RA TA TERMINAL LINEIO LINE MODE BPS SW MCS 

********************************************************************************************************************************** 

***** N0 STATIONS ON NSP 112 ***** 



GRAPH 



ON-LINE OATACOM NETWORK ANALYSIS PROGRAM 

======= ======= ======= ======== ======= 



SYSTEM/DCSTATUS (3.9.30) DATE : 08/06/90 TIME : 13:28:53 

OCPREFIX: MPA15C 



******************** ******************** ******************** ******************** 

* * * * * i tut s nq * * ni * , n-n-n * 

* NSP 107 ************ LSP 116 ************ X25071600 ************ X25T0CDN * 

* I * III ADAPTER * 0 * * X25TERMINAL * 

*** ** ICU a Aft* * 

******************** ******************** * ******************** ******************** 

* 

* ******************** ******************** 

* * LINE » 118 * * DLS » 0:1:0 * 
****** 8NAO71601 ************ BDLCMPCP061 * 

* ADAPTER » 1 * * DCDLP BDLCTERM * 

* * * LSN »~483 * 
******************** ******************** 

******************** ******************** ******************** ******************** 



* 



LINE » 120 * * DLS * 1:0:0 



* NSP 110 ************ LSP 121 ************ T0102100 ************ t«m 

*. * * II! ADAPTER » 0 * * TD19200 

*** * * * I s JRt * 

******************** ******************** * ******************** * ******************** 

* • 

* * ******************** 

* * * DLS » 1:0:1 * 

* ****** JB240 * 
I II TD19200 * 

* * * lsN * 486 * 

* * ******************** 

* * 

* * ******************** 

* * * ni* a 1:0:2 * 

* ****** TB243 * 

* II TD19200 * 

* * ******************** 



TERMINAL 

ON-LINE OATACOM NETWORK ANALYSIS PROGRAM 



SYSTEM/DCSTATUS (3.9.30) DATE : 08/06/90 TIME : 13:22:18 

OCPREFIX: SJA15C 



TERMINAL PLOTTERTERM: 
COMMENTS = ""; 

TYPE * TTYTYPE; 

SCREEN = TRUE; 

WRAPAROUND » FALSE; 

LINEWIOTH * 80; 

MAX INPUT « 1920: 

MAXOUTPUT = 1920; 

PAGECOUNT - 0; 

PAGES I ZE » 24; 

RECEIVEOELAY » 0; 

TRANSMITDELAY » 0; 

RECEI VEAOORLENGTH = 0: 

TRANSMITADORLENGTH = 0; 

TERMINAL AOMTERM: 

COMMENTS = n "; 

TYPE « AOMTYPE; 
SCREEN * TRUE; 
WRAPAROUND = TRUE; 
LINEWIOTH = 80: 
MAXINPUT = 1926: 
MAXOUTPUT = 1920; 
PAGECOUNT = 0; 
PAGESIZE » 24; 
RECEIVEOELAY = 0: 
TRANSMITDELAY « 0; 
RECEI VEAOORLENGTH = 0: 
TRANSMITAOORLENGTH = 0; 



ON-LINE DATACOM NETWORK ANALYSIS PROGRAM 

SSSSSS3 ======= ======= =======3 ======= 



SYSTEM/OCSTATUS (3.9.30) 

DCPREFIX: SJA15C 



DATE : 08/06/90 TIME : 13:29:18 



STATION 2 



STATION NAME = ADMSTA 
TERMINAL NAME = ADMTERM 
OCC STATION TABLE 



500140026050 



6F020A640001 
000000000000 



WRAPAROUND : ENABLED : READY : 
MCS = 5: LSN * 2 : WIDTH = 80 

STATION REMOTE TYPE = 2: RETRY COUNT = 10: NIF INDEX = 1 
PRIMARY 0 = 0 .CURRENT Q = O.STN Q = O.PSEUDOMCS = 0 



000000000000 DLS : UNASSIGNED 



STATION 3 



STATION NAME = ADMSTA1 
TERMINAL NAME = ADMTERM 
DCC STATION TABLE 
541040036050 WRAPAROUND 



ATTACHED 



ENABLED : READY : 
MCS = 1: LSN = 3 : WIDTH = 80 
6F020A640002 STATION REMOTE TYPE = 2: RETRY COUNT = 10: NIF INDEX = 2 
840000025025 PARTICIPATES : ALL RESULTS : 

PRIMARY 0 = 37, CURRENT Q = 37.STN Q = O.PSEUDOMCS = 0 
UNASSIGNED 



000000000000 DLS 



STATION 4 



STATION NAME = A0MSTA2 
TERMINAL NAME - ADMTERM 
DCC STATION TABLE 
541040046050 WRAPAROUND 



ATTACHED 



ENABLED : READY : 
MCS = 1: LSN = 4 : WIDTH = 80 
^828A§59992 STATION REMOTE TYPE = 2: RETRY COUNT = 10: NIF INDEX * 3 
840000025025 PARTICIPATES : ALL RESULTS : 

PRIMARY Q = 37, CURRENT Q = 37.STN Q = O.PSEUDOMCS = 0 

000000000000 DLS : UNASSIGNED 



Section 4 
DUMPANALYZER 



The DUMPANALYZER utility produces user-specified subsets of information from 
a memory dump or a program dump and analyzes that information according to 
parameters given by default or supplied by the user. 

A Series systems have the ability of performing an enhanced memory dump. The 
enhanced memory dump mechanism is capable of creating a COMPLETE, ALLINUSE, 
or PARTIAL dump. 

A COMPLETE dump is considered to be the entire memory image. An ALLINUSE 
dump is a refined COMPLETE dump and captures only the in-use areas (those present 
in memory). A PARTIAL dump is a subset of an ALLINUSE dump. By default, the 
PARTIAL dump includes the following areas: 

• The dumping stack and all the areas owned by the stack. 

• The area occupied by all the stacks in a running system, that is, the area from 
BOSR to LOSR of each stack. 

• All the areas owned by the MCP 

• The ASD tables. 

• Any stack and its associated areas that are linked into the dumping stack's 
GRAPHHEADWORD and PROCESSFAMILYLINK, or one of the two. 

• For systems that include task control processors (TCPs), some relevant TCP state 
information. This includes events, PO. boxes, and approximately 93 words of 
statistical data for each stack being dumped. 

Multiple-processor systems and single-processor systems perform memory dumps in 
the same manner. When one processor of a multiple-processor system performs a 
memory dump, the stacks of all the processors in that system are also dumped. 

The DUMPANALYZER utility is capable of analyzing all types of memory dumps. 
DUMPANALYZER is also capable of analyzing program dumps that were directed to 
disk by the TODISK program dump option. 

Note that DUMPANALYZER requires the presence of the SDASUPPORT system 
library to help analyze both memory dumps and program dumps. 

General Information 

This section is intended as a reference source for experienced programmers who are 
familiar with the master control program (MCP). Because no single memory dump is 
typical, no attempt is made here to explain how a memory dump is read. This ability 



8600 0478-100 



4-1 



DUMPANALYZER 



can be acquired only through experience and a thorough knowledge of the system 
software. 

System types are identified within this section as follows: 

Entry and Medium Systems Micro A, A 1, A 2, A 3, A 4, A 5, A 6, A 9, A 10 

(EMS) systems 

Host data unit (HDU) systems A 12, A 1 5 

Resource management A 16, A 17 

module (RMM) systems 



DUMPANALYZER Files 

DUMPANALYZER uses three files: OPTIONS, TAPEIN, and MCP CODEFILE . 
File-equating these files is sometimes desirable when DUMPANALYZER is run using a 
Command and Edit (CANDE) language or Work Flow Language (WFL) RUN statement 
or using Menu-Assisted Resource Control (MARC). These files are described as follows: 

OPTIONS OPTIONS is the file name of the user input file. When 

DUMPANALYZER is run from an ODT, OPTIONS should 
be file-equated to ODT. For example: 

RUN SYSTEM/DUMPANALYZER;FILE QPTIQNS(KIND=QDT) 

TAPEIN TAPEIN is the file containing the memory image created 

by the memory dump routine in the MCP. 

TAPEIN is declared as a tape file titled 
MEMORY/DUMP. It can also be file-equated to either of 
the following kinds of files: 

• A disk file that is titled 
DP/<MMDDYY>/<HHMM>/<REASON_ID>, 
where MMDDYY represents month, day, and year, 
and HHMM represents hour and minutes. This file 
can be a "pseudorecovery" file created during the 
initialization of DUMPANALYZER, or it can be a DP 
file. DP files are created in the following manner. If 
the DN (Dump Name) system command was 
previously used to create a dump-to-disk file, the 
system directs memory dumps to the dump-to-disk 
file instead of to tape. After the memory dump, the 
DUMPDISKMASTER independent runner appears 
in the mix and prompts the operator to indicate 
whether dumps should be copied out of the 
dump-to-disk file into DP files. The operator can 
also initiate DUMPDISKMASTER at a later date 
with the DF (Empty Dumpdisk File) system 
command, and direct DUMPDISKMASTER to 
create the DP files at that time. 

• A file created using the DUMPANALYZER SAVE 
command. 

continued 
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continued 

MCPCODEFILE The code file of the MCP that was running at the time 

of the dump. This file contains the MCP names and 
index arrays (and might contain LINEINFO information) 
for analyzing stack bases, process information blocks 
(PIBs), and file information blocks (FIBs). The file can 
be successfully file-equated only to MCP code files 
closely related to the code file that took the dump. For 
example, the 3.8 version of DUMPANALYZER cannot 
read a 3.9 dump. This file is not required when a 
previously saved file is equated to TAPEIN. 

PSEUDORECOVERY File During the initialization sequence of DUMPANALYZER, 

the MEMORY/DUMP file is accepted as input and 
certain data structures are built up. When initialization 
is complete, this data structure information is saved in 
a pseudorecovery file under the user's usercode. This 
file has the name 

DP/<MMDDYY>/<HHMM>/<REASON_I D> 

MMDDYY represents month, day, and year, and HHMM 
represents hour and minutes. 

If the DUMPANALYZER run is interrupted by a halt/load 
or terminated by an operator, this pseudorecovery file 
can be file-equated to TAPEIN and used as input to 
DUMPANALYZER. When a pseudorecovery file is used, 
the MCPCODEFILE must be file-equated to the MCP 
code file that was in use at the time of the dump. 

If for any reason the user wishes to exit from the 
DUMPANALYZER session, considerable time and 
resource savings will be made if the RECESS command 
is used rather than the STOP or BYE command. The 
RECESS command does not remove the 
pseudorecovery file, while the other two commands do. 
In all cases DUMPANALYZER does not remove the file 
that was used as input. 

The user should be aware that the pseudorecovery file 
is removed if the SAVE command is issued and 
successfully completed. For advice on when to use the 
SAVE command, refer to the following subsection, 
"Saved Memory Dumps." 

continued 
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continued 

DUMPANALYZER can request exclusive access to the 
pseudorecovery file during initialization or while 
processing a SAVE command. This exclusive access is 
necessary to prevent any interference with other 
instances of DUMPANALYZER using the same 
pseudorecovery file. If DUMPANALYZER does have 
exclusive access to the pseudorecovery file and another 
DUMPANALYZER transaction is initiated, one of the 
processes must wait while the message "WAITING 
FOR: < pseudorecovery title>" is displayed. If this 
delay is not acceptable, the user can initiate the second 
instance with a different primary family for DISK, or by 
using a different usercode. 

Even if DUMPANALYZER is running with FAMILY substitution in effect, the program 
initially ignores the FAMILY substitution when searching for MCP and program 
code files referenced in the dump. For those files that are not found by this method, 
DUMPANALYZER searches again, using FAMILY substitution. 

Note that the CODEFILE FAMILY form of the CODEFILE command can be used to 
establish the family for all object code files referenced in the dump. If this command is 
used, DUMPANALYZER ignores the family names that object code files had at the time 
of the dump, and also ignores FAMILY substitution. 



Saved Memory Dumps 

If a memory dump is to be sent to Unisys for analysis, the user should first run 
DUMPANALYZER on the dump and use the SAVE command. In general, the SAVE 
command should also be used if the dump is being saved for analysis at a later date 
when the original MCP code file might not be available. 

In the DUMPANALYZER session when the SAVE command is run, the MCP code file 
that is file-equated to MCPCODEFILE should be identical to the one that was running 
on the system when the dump was created. The SAVE command creates a saved dump, 
which contains the memory image from the original dump tape together with relevant 
data from the MCP code file. The saved dump is usually an extremely large file and is 
often stored on tape. 

When DUMPANALYZER is run to analyze a saved dump file, the file TAPEIN should 
be file-equated to the saved dump file. The MCPCODEFILE does not have to be 
file-equated, and the MCP code file that produced the dump does not need to be present. 

Compatibility of MCP Levels 

DUMPANALYZER checks to determine the difference between the DUMPANALYZER 
Mark level and the MCP Mark level on the dump tape. If the levels are not the same, 
DUMPANALYZER terminates with an error message similar to the following, where nn 
is the MCP operating system Mark level and mm is the DUMPANALYZER Mark level: 

CANNOT ANALYZE nn MEMORY DUMP WITH mm DUMPANALYZER 
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In some cases, DUMPANALYZER allows analysis of a wrong level MCP when the 
run-time option MEMONLY is chosen. The error message indicates when this is the 
case. It is always better to use the correct level DUMPANALYZER. 

If the MCP code file equated to MCPCODEFILE does not have the same timestamp 
as the MCP in use at the time of the memory dump, the following error message is 
displayed: 

ACCEPT: WRONG CODE FILE—OK OR RESTART 

The operator enters OK if DUMPANALYZER should continue using the same MCP 
code file. If RESTART is entered, the code file is closed and DUMPANALYZER will look 
for a file on DISK titled MCPCODEFILE. The operator should then use the FA (File 
Attribute) system command to specify the desired MCP code file. 

Running DUMPANALYZER 

DUMPANALYZER can be run from a remote terminal, an ODT, or in batch mode. Each 
command is processed before the following command has been parsed. 

Remote Operation 

To initialize an interactive DUMPANALYZER session at a remote terminal, enter a 
RUN command from a CANDE or MARC session. When necessary, file-equate the 
input dump file to TAPEIN and the MCP that was running to MCPCODEFILE in the 
RUN statement. The following are examples: 

RUN *SYSTEM/DUMPANALYZER ON MY PACK; 

FI LE TAPEIN (KIND=DISK,TITLE=ER/DUMP) 

R *SYSTEM/DUMPANALYZER;FILE TAPEIN (SERIALN0=" 10046") ;FILE 
MCPCODEFILE(KIND=DISK,TITLE=SYSTEM/MCP34180) 

A MARC menu selection for running DUMPANALYZER also exists. 

After the RUN statement, DUMPANALYZER displays the following messages: 

DUMPANALYZER VERSION 37.000.00000 
SELECT RUN TIME OPTIONS: PRINTER, REMOTE, DISKFILE, 
DEBUG, MEMONLY 



The following diagram shows the syntax of the response the user can enter at this 
point: 
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q , i 1 

- REMOTE 

- PRINTER 

- DISKFILE — " — <file title>— ■ - 

- DEBUG 

L- MEMONLY • 

Note that multiple options are separated by blank spaces, not by commas. Further, if 
more than one of the destination options (PRINTER, REMOTE, and DISKFILE) are 
included, only the last one is really used. If none of the destination options is included, 
REMOTE is used by default. 

The following text describes the meaning of each option: 

(blank line) Transmitting a blank line has the same effect as the REMOTE 

option. 

REMOTE Causes the output from all DUMPANALYZER commands to be 

directed to the terminal. 

PRINTER Causes the output to be directed to a printer backup file. 

DISKFILE "<file title>" Causes output to be directed to the specified disk output file. 

DEBUG Causes diagnostic information related to DUMPANALYZER to be 

displayed. 

MEMONLY Allows a restricted analysis of memory dumps. A subset of the 

DUMPANALYZER commands are available in this mode. The 
available commands are displayed after the message 
"FUNCTIONS CURRENTLY AVAILABLE ARE:". 

After the desired option or options are transmitted, DUMPANALYZER initializes. 
When DUMPANALYZER is ready to accept commands it displays the following prompt: 

: READY 



If DUMPANALYZER is initiated with the task equation VALUE = i, then 
DUMPANALYZER does not prompt the user for run-time options. Instead, 
DUMPANALYZER assumes that only the REMOTE option is to be used. 

ODT Operation 

Three methods can be used to initiate DUMPANALYZER using the ODT. Only limited 
output is sent to the ODT, such as the HELP command information. Output from 
most commands is sent to the printer as soon as the session terminates. If the RELX 
command is in effect, information is sent to the printer during the session. 

Method 1 

In the first method, enter the following: 

RUN SYSTEM/DUMPANALYZER; FILE OPTIONS (KIND=ODT) 
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When necessary, file-equate the input dump file to TAPEIN and the MCP that was 
running to MCPCODEFILE in the RUN statement. 

The following message is then displayed: 
INITIALIZING 

FUNCTIONS CURRENTLY AVAILABLE ARE 

A list of commands is then displayed, and the system displays the following message: 

"HELP" FOR THIS LIST, "HELP HELP" FOR MORE INFO 
DUMPANALYZER continues to initialize and then displays the following message: 

ENTER REQUESTS 
DUMPANALYZER commands can now be entered. 

Method 2 

The second method uses the DA (Dump Analyzer) system command, Refer to the 
A Series System Commands Reference Manual for a complete description of the DA 
command. 

Enter the appropriate form of the DA command and transmit. The following message 
is then displayed: 

INITIALIZING 

FUNCTIONS CURRENTLY AVAILABLE ARE 
A list of commands is then displayed, and the system displays the following message: 

"HELP" FOR THIS LIST, "HELP HELP" FOR MORE INFO 
DUMPANALYZER continues to initialize and then displays the following message: 

ENTER REQUESTS 
DUMPANALYZER commands can now be entered. 

Method 3 

If DUMPANALYZER is run on an ODT configured in data comm mode, it should be 
initiated using MARC. This is done by entering ??MAMC, logging on to MARC, and 
proceeding with the REMOTE OPERATION instructions. 
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Batch Operation 



Batch runs of DUMPANALYZER can be initiated from Work Flow Language (WFL) 
jobs. 

When DUMPANALYZER is initiated from a WFL job, the STATION task attribute 
usually defaults to a value of 0. If the STATION value is 0, then output is directed to 
the printer by default. 

The following paragraphs outline two methods that can be used to run 
DUMPANALYZER from a Work Flow Language (WFL) job. 

Method 1 

In this method, DUMPANALYZER commands are provided in a local data specification 
in the WFL job. The following is an example of such a WFL job: 

BEGIN JOB ANALYSIS; 

RUN SYSTEM/DUMPANALYZER; 

DATA OPTIONS 

SUMMARY 

LOCKS 

DEADLOCK 

10 UINF0 NAMES ALL 

OPT 

MEM 

TRACE 

BOX INFO 

MODE + ALL 

STACK 123 ACTIVE SUMMARY 
NAMES 

AREAS AVAIL CODE LINKS 
DC 

END JOB 



Method 2 

In this method, the WFL job directs DUMFANALYZER to read commands from a disk 
file. The following WFL job directs DUMPANALYZER to read commands from the disk 
file titled DPA/INPUT: 

BEGIN JOB ANALYSIS; 

RUN SYSTEM/DUMPANALYZER; 

FILE OPTIONS (KIND=DISK,TITLE=DPA/INPUT,DEPENDENTSPECS=TRUE) ; 
FILE TAPEIN(KIND=DISK,TITLE=MEMORY/DUMP) ; 
END JOB 
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Analyzing Program Dumps 

DUMPANALYZER can be used to analyze both system dumps and program dumps. 
This subsection discusses the uses of DUMPANALYZER that are exclusive to program 
dumps. 

DUMPANALYZER can analyze program dumps that have been directed to a disk file. 
Many of the DUMPANALYZER commands that are used for system dumps can be used 
for program dumps. The output from these commands is limited to the information 
available in the program dump file. For example, the SUMMARY command produces a 
listing of only dumped stacks. 

The following DUMPANALYZER commands can be used when a program dump is 
analyzed: 



ARRAYLIMIT 


ASDNUMBER 


BYE 


DEBUG 


FIB 


GRAPHS 


HDR 


HEADING 


HEAP 


HEAPSTACK 


HELP 


IOCB 


KEEP 


LIB 


LINKS 


LOADXREF 


MASK 


MD 


MIX 


MODE 


MSCW 


NAMES 


OPT 


PATTERN 


PIB 


PORT 


PRINTARRAY 


PRINTCODE 


PRINTER 


PRINTVAL 


PROCSTACKS 


PROGRAMDUMP 


RECESS 


RELEASE 


RELX 


REMOTE 


REPEAT 


RIGHTJUST 


SEARCH 


STACK 


STACKWINDOW 


STOP 


SUBPORT 


SUMMARY 


USE 


WHERE 


WHO 





DUMPANALYZER still displays identifier names for either the MCP or the user 
environments when analyzing a program dump. Note that the SAVE command is not 
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available for use with program dumps. Therefore, the relevant code files must be 
present at the time of the analysis. 

Input to DUMPANALYZER 

The following subsection, "Basic Constructs," describes the syntactic variables 
commonly used in the addressing and value schemes specified in various 
DUMPANALYZER commands. "DUMPANALYZER Commands" in this section 
provides detailed descriptions of each of the commands that can be used as input to 
DUMPANALYZER. 

Basic Constructs 

The addressing and value schemes used in the syntax diagrams of DUMPANALYZER 
commands commonly employ certain basic syntax constructs. 

<number> 

T<hexadecimal number> 1 1 
DEC — <decimal number>— 
OCT — <octal number> ' 

The following text describes the meaning of each variable: 

< hexadecimal number> A number in base 16, each of whose digits ranges from 0 to F. 

In DUMPANALYZER commands, <number> is assumed to be 
hexadecimal unless it is preceded by a prefix such as DEC 
(decimal) or OCT (octal), indicating another base. 

<decimal number> A number in base 10, each of whose digits ranges from 0 to 9. 

In DUMPANALYZER commands, <number> is decimal when it 
is preceded by the prefix DEC. 

<octal number> A number in base 8, each of whose digits ranges from 0 to 7. In 

DUMPANALYZER commands, <number> is octal when it is 
preceded by OCT. 

Simple Address 

A < simple address > represents a location in memory. One of the common uses of the 
< simple address > construct is in the MD command, described later in this section. 

A < simple address > is made up of an < absolute address > or a < simple location> 
followed by an optional offset. Three types of <simple location>s exist: stack-related, 
global, and indirect. The <offset> is a number that indicates the displacement of the 
< simple address > from the given < simple location > or < absolute address >. 
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<simple address> 

<absolute address>— p 

-<simp1e location> — ' 

-<stack ID> 



- + -j-<offset; 



<absolute address> 
— <number> 



<simple location> 

<stack ID>— r— <stack offset>- 



BASE — |— <attri bute name>- 



— PIB — <stack number>— i— <attri bute names 
L # — <offset> — 



# — <offset> 

ber>— r 

- G -r-<global ID> 

L- # _< 0 ffset>— 
RV — <simple value>- 
>- VIA — <ASD number>— 



<stack ID> 



STK — <hexadecimal stack number> 



i — — MicAduet i mo i itdtii nuinuer^"^ — i — i r 

L_ a 1 L_ sd -J 



<stack offset> 



LOSR 



- BOSR H 

- SREG 
FREG — 1 



<offset> 
— <number>- 



Explanation 

obsolute address> A hexadecimal, decimal, or octal number that specifies an 

address within a present, online memory module. The prefixes 
DEC and OCT are required if decimal or octal numbers are 
specified. The minimum valid address is 0. The maximum valid 
address is determined by the memory capacity of the system. For 
example, on a Micro A system with 2 megawords of memory, the 
command MD 1FFFFF is valid. 

<simple location> Specifies locations in memory that are stack-relative, global 

identifiers, or indirect. 

The following groups of variables represent valid <simple 
location>s; expansions of some of the variables within those 
groups are included: 

continued 
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< stack ID> 



A <simple location> can consist of a <stack ID>. A <stack 
ID> specifies a stack by number or uses the last stack explicitly 
referenced. An expansion of the variable <stack ID> follows: 

STK <hexadecimal stack nuraber> 
STK <hexadecima1 stack number> SD 



< stack ID> < stack offset > 



<stack ID> BASE <attribute name> 

<stack ID> BASE <offset> 

PIB <stack number> ottribute 
name> 

PIB <stack number> <offset> 



G <global ID> 
G < offset > 



@ SD 

These four statements are all expansions of the variable <stack 
ID>. STK indicates that a stack is involved. <hexadecimal stack 
number> specifies the hexadecimal number that identifies the 
stack. The last stack explicitly referenced is represented by the at 
sign (@). Referencing a stack by its hexadecimal number sets up 
the @ for subsequent use. The segment dictionary of the stack 
can be referenced if the stack number or the at sign (@) is 
followed by SD. 

A <simple location > can consist of a <stack ID> (as defined 
previously), followed by a specific location within the stack, 
which is called the <stack offset >. An expansion of the token 
<stack offset> follows: 

• LOSR = Limit-of-stack register 

• BOSR = Bottom-of-stack register 

• SREG = S register 

• FREG = F register for environment stacks (that is, stacks 
that are not segment dictionaries). 



For some other possible <simple location>s, the stack BASE and 
process information block (PIB) of the stack can also be used; a 
<stack ID> (with BASE) or <stack number> (with PIB) must be 
specified. In addition, either an <offset> or an attribute name 
must be identified. The ottribute name>s are listed in the MCP 
symbolic; they change with each new release. Since the 
availability of the cell names depends on the presence of the 
MCP code file, these cell names are not valid if the task (PIB) and 
stack index arrays cannot be generated. 



These are <simple location >s that are global IDs (operating 
system D[0] cells). The G denotes that the location is global. The 
<offset> indicates a displacement of a given number of words 
away from D[0]. 



continued 



4-12 



8600 0478-100 



DUMPANALYZER 



continued 



RV <simple value> 



VIA <ASD number> 



+ <offset> 
- < offset > 



Addresses can also be indirectly specified by using the RV (the 
reference value), option. For example, if a cell contains an 
absolute address, an indirect reference word (IRW), or a stuffed 
indirect reference word (SIRW), the RV option allows the contents 
of this cell to be used as an indirect address. (An IRW would 
require that an environment be set up, but an SIRW would not; a 
set up environment implies that a stack has already been 
referenced.) An absolute address would be used as is. The actual 
value that can be used for indirect addressing is a <simple 
value>, which is defined later in this subsection. Each level of 
indirection is printed as it occurs so that each chain of addresses 
can be seen along with the referenced data. 

A <simple location > pointed to by an <ASD number>. The 
<ASD number> can be any number from 1 through the largest 
valid actual segment descriptor (ASD) that is specified in 
ASD1[0]. 



An <offset> is a hexadecimal, decimal, or octal number that 
specifies the number of words away from a reference point such 
as a <simple location>, that a particular address is located. If an 
<offset> is specified in decimal form, DEC should precede it. If 
an <offset> is specified in octal form, OCT should precede it. 
The offset either increases (+) or decreases (-) the address. 



Examples 

In the following examples, blank spaces and special characters function as delimiters. 
Delimiters are needed whenever two alphanumeric items are juxtaposed. 



41AC0 
DEC 47990 
OCT 170071 

STK 4A BASE LOCKCOUNT 
PIB2E7 ASDSINUSE 
PIB 2E7 # 5F 
@ SD LOSR 
G HLUNIT 
RV M[47AB] 



%ABSOLUTE ADDRESS 
% ABSOLUTE ADDRESS 
% ABSOLUTE ADDRESS 
%BASE ADDRESS (STACK-RELATED) 
%PIB ADDRESS (STACK-RELATED) 
%PIB ADDRESS (STACK-RELATED) 
%INVARIANT STACK-RELATED ADDRESS 
%GLOBAL IDENTIFIER ADDRESS 
%INDIRECT ADDRESS 



Multiple Addresses 



The < multiple addresses > variable provides for the specification of more than one 
address. The addresses generated by these expressions are treated as sequences; that 
is, the first address in the sequence is generated and passed to the execution routine 
that requires it. Then, the next address is generated, and so forth, until the list is 
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exhausted. The addresses are generated in the proper order, with memory addresses 
increasing, except in the case of stack-related addresses, in which case, the addresses 
are generated from LOSR to BOSR. These rules hold true even when the specification 
by the user differs from the proper order. 

<multiple addresses> 



-<simple address>- 



E 



<until part 



<until part> 



T 



FOR 



<simple value>- 
ALL 



TO 



T<offset> 
<stack offset^ 
END 



The following text describes the description of each variable: 



<until part> 
FOR ALL 

FOR <simple value> 

TO < offset > 

TO < stack offset > 

TO END 



The < until part> specifies over what range a list of < multiple 
addresses> should extend, from an initial location. 

Indicates that all the addresses from the initial location to the 
end of the area referenced by the descriptor that provided the 
initial location are to be included as part of the < multiple 
addresses>. 

Here the <simple value> indicates the number of consecutive 
addresses to be included in the <multiple addresses> list. 
<simple value> is defined later in this subsection. 

Here the <offset> indicates the displacement of the highest 
address to be included in that part of the <multiple addresses>. 

Here the <stack offset> indicates that all addresses up to the 
indicated location in the stack (BOSR, LOSR, SREG) are to be 
included as part of the <multiple addresses>. 

Indicates that all the addresses from the initial location to the 
end of the area referenced by the descriptor that provided the 
initial location are to be included as part of the < multiple 
addresses>. 



Note: Only one <absolute address> per statement is allowed. Multiple 
stack references must reference the same stack. 



Examples 

The following are examples of possible <multiple addresses>. Each example uses a 
different form of the < until part>. 

3BAC FOR 20 Specifies the region starting at absolute 

address 3BAC and extending for 20 words. 

3BAC TO 3BCB Specifies the region extending from absolute 

address 3BAC to absolute address 3BCB. 

continued 
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continued 



STK 32 LOSR TO BOSR 



STK 11C BASE BDINFO FOR ALL 



Specifies the region extending from the 
bottom of stack address (BOSR) for stack 32 
to the limit of stack address (LOSR) for the 
same stack. DUMPANALYZER ignores the 
fact that LOSR and BOSR appear in reverse 
order in the address. 

Specifies the entire region referenced by the 
BDINFO word in process stack 1 1C. 



Simple Value 



A < simple value > is a single scalar value either denned by the user or derived from a 
value in a memory location or in a stack. A < simple value > is a <word value > followed 
by an optional < concatenation > value. The < simple value > construct is often used in 
the PV command. 

<simple value> 
— <word value>- 



-<concatenati on>- 



<word value> 
— <simple word>- 



17 



-<partial wor 



<simple word> 

- M — [ — <hexadecimal address^— ] 

- C — ( — t— <simple "locations — r— ) - 
I— <absolute address>— * 

-<n umb e r> 



<si'mple location> — i— [ — <simple index list> — ] — 
— <absolute address>-J 

( — <simple value> — ) — - -— 



<simple index list> 

r* • 1 

— L -<simple valued 



<partial word> 



-i— [ — <simple value> — : — <simple value> — ] 
L TAG 
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<concatenation> 
— <word valuer— 



i— [ — <left bit to> — 
\- [ — <left bit to>— 
L TAG 



-<left bit from>- 
-<bit count> — ] 



'b\t count> — ] 



<left bit to> 
— <simple value>- 



<left bit from> 
— <simple value>- 



<bit count> 

— <simple value>- 



The following text describes the meaning of each variable: 



<word value> 

M [<simple address>] 

C ( <simple location> ) 
C ( < absolute address> ) 



<number> 



<simple location > 
[ <simple index list> ] 

< absolute address> 
[ <simple index list > ] 



< partial word> 



A <word value> is a <simple word> with an optional < partial 
word>. The following groups of tokens represent valid <simple 
word>s; expansions of these tokens are also given. 

M signifies memory. The contents of the memory location at 
<hexadecimal address> is one type of <simple word>. This 
operation is the same as subscripting the MEMORY array. 



C signifies contents. The C option can be used to obtain the 
contents of any <simple location> or obsolute address>. 
<simple location> and obsolute address> are defined under 
<simple address>, one of the preceding items in "Basic 
Constructs." 

This construct is defined under "Basic Constructs," earlier in this 
section. 

Note: A <number> is assumed to be hexadecimal 
unless preceded by DEC or OCT. For example, 
to indicate bit 47 for 6 in a <partial word>, 
either of the following constructs could be used: 
[2E:6] or [DEC 47:6]. Similar considerations 
apply to the <concatenation> construct. 



A <simple location> or obsolute address> can be indexed, 
and the derived value can be used as a <simple word>. This 
method of forming values is valid only if the word specified 
(which can be reached through an IRW chain) is an unindexed 
data descriptor, and the number of indexes specified matches 
the number of dimensions in the array. 

A <partial word> is an optional component of a <word value>. 
When a partial word is present, the <word value> is the value 
of a selected group of bits within the <simple word>. < partial 
word> specifies a particular group of bits within the <simple 
word>. 



continued 
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<simple value>:<simple 
value> 



TAG 



<concatenation> 



<word value> [< left bit 
to>:<left bit from>:<bit 
count>] 



<word value> [< left bit 
to>.-<bit count >] 



<word value> TAG 



Two <simple value>s separated by a colon (:) make up a 
<partial word>. The first <simple value> indicates the number 
of the starting bit in a range. The second <simple value> 
indicates how many bits the range extends over (heading from 
47 down to 0). 

When TAG is specified as the < partial word>, then <word 
value> is the value of the 4-bit TAG in the attached <simple 
word>. 

The <simple value> consists of a <word value> & 
concatenation >. In the context of concatenation, <word 
value> is a 48-bit, binary word. The < concatenation > variable 
includes within itself a second <word value>, along with bit 
specifiers and a bit count; the specifiers and count indicate a 
substitution of certain bits to be made from the second word 
value into the first. For further information about bit 
manipulation, see the A Series ALGOL Programming 
Reference Manual, Volume 1: Basic Implementation. 

Here, <word value> represents a binary, 48-bit word with a 
4-bit tag value. The word value in the < concatenation > is the 
source word, while the word value that preceded the ampersand 
(&) is the destination word. The <left bit to> variable defines 
the highest (ranging from 0 through 47) bit number in the 
destination word. The < left bit from> variable defines the 
highest (ranging from 0 through 47) bit location in the source 
word. The <bitcount>, ranging from 1 through 48, specifies 
the length of the data field to be moved from the source word to 
the destination word. 

The <word value> variable represents a binary, 48-bit word 
with a 4-bit tag value. The <left bit to> variable defines the 
highest (ranging from 0 through 47) bit number in the 
destination word. In this case, the <left bit from> specification 
is understood to coincide with the <left bit to> specification. 
Again, <bit count> specifies the length of the data field to be 
moved from the source word to the destination word. 

Here <word value> represents a binary, 48-bit word with the 
preceding tag value. TAG indicates that the TAG of the source 
word should be substituted for the TAG in the destination word. 



Examples 

In the following examples, blank spaces and special characters function as delimiters. 
Delimiters are needed whenever two alphanumeric items are juxtaposed. 



M[47AC] 

C(G HLUNIT) 

DEC 123456 & 3 TAG 

C (STK 53 BOSR).[6:2] 



% MEMORY LOCATION 
%CONTENTS OF SIMPLE LOCATION 
%CONCATENATION 
%PARTIAL WORD 
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DUMPANALYZER Commands 

The following text describes the commands that can be used when running 
DUMPANALYZER. These commands allow the user to select the type of analyses to 
be done on the dumped data. Multiple commands separated by semicolons (;) can be 
entered on the same line. 



ALLPORTS 

The ALLPORTS command displays information about all the port files in the dump. 
This command is valid only for dumps in which the running BNA version was BNAV2. 

— ALLPORTS 1 



Because this command in most cases produces many thousands of lines of output, it 
should be used sparingly. 

If the global PORT_ARRAY_DESC value is zero, indicating that either no ports were 
set up or BNAV1 was in use, an appropriate negative response is returned. 

The output from the ALLPORTS command is similar to the output from the PORT 
command, except that ALLPORTS displays all ports instead of just one. An example of 
the PORT output is given in the PORT command description later in this section. 



AREAS 



The AREAS command prints the contents of memory areas. The command allows the 
user to specify what areas of the dump are to be analyzed and what information is to be 
displayed. 



In general, all memory can be analyzed. However, in split code and data environments 
on HDU systems, only the data environments are analyzed. 



<areas> 



— AREAS 



- AVAIL 

- DATA 

_ CODE 

— SIZE — <number> 

-/1\- ODDBALL — <oddball field>- 

RANGE — <multiple address: 



-<output selections- 



output selection> 



/3\-r- CONTENTS 
STATS 



|- LINKS 
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<oddball field> 

— r BOXINFOAREA r 

- BUFFERHEADER 

- CODEAREA 

- DCQAREA 

- DIRECTIOBUFF 

- DOPEOREVENTAREA — 

- DOPEVECT 

- EVENTARRAY 

- FIBMARK 

- ICMMARK 

- INSTACKAREA 

- IOCBAREA 

- IOCDAREA 

- MESSAGEAREA 

- MESSAGEMOMAREA 

- NORMA LAREA 

- PERMSAVEAREA 

- PIBMARK 

- PROCINFOAREA 

- PROCREFARRAY 

- RESERVEEVENTAREA - 

- RESERVEAREA 

- SAVECODEAREA 

- SEGDOPE 

- SEGSEG 

- SIBMARK 

- SORTAB 

- STACKMARK 

- STALISTAREA 

- SUBSPACE_ARRAY 

- TABMARK 

L UINFOAREA 1 



The following text describes the meaning of each variable: 



AREAS 

<output selection > 

AREAS AVAIL 

< output selection > 

AREAS DATA 
<output selection > 

AREAS CODE 

< output selection > 

AREAS SIZE <number> 

< output selection > 

AREAS ODDBALL 
<oddball field > 
<output selection > 



All memory areas that contain data or code, or that are available 
are analyzed. 

All memory areas that are available are analyzed. 

All memory areas that contain data are analyzed. 

All memory areas that contain code segments are analyzed. 

All memory areas of the designated size are analyzed. 

All memory areas that contain the item designated in the oddball 
field are analyzed. 

The items that can be specified as an oddball field are defined as 
follows: 



BOXINFOAREA 

BUFFERHEADER 

CODEAREA 



The area is part of the 
BOXINFO array. 

The area contains information 
about input/output (I/O) buffers. 

The area contains code. 
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DCQAREA 
DIRECTIOBUFF 

DOPEOREVENTAREA 
DOPEVECT 

EVENTARRAY 

FIBMARK 

ICMMARK 

INSTACKAREA 

IOCBAREA 

IOCDAREA 

MESSAGEAREA 
MESSAGEMOMAREA 

NORMALAREA 

PERMSAVEAREA 
PIBMARK 

PROCINFOAREA 
PROCREFARRAY 
RESERVEAREA 



The area is a DCQUEUEHEAD 
area. 

The area contains a direct 
array. 

The area is a bad event. 

The area contains a dope 
vector; this dope vector 
includes mom descriptors. 

The area contains an event 
array. 

The area contains a file 
information block (FIB). 

The area is a connection block. 

The area is an in-stack array. 

The area contains an I/O 
control block (IOCB). 

The area is for I/O control direct 
(IOCD) use. 

The area is a message. 

The area contains message 
MOMS. 

The area is a "normal" area 
that does not contain any of the 
structures indicated in the rest 
of the option list. 

The area is a permanent save 
area allocated by GETITGOING. 

The area contains a process 
information block (PIB) or task 
variable, or a segment 
dictionary pseudo-PIB. 

The area is part of the 
PROCINFO array. 

This area contains a procedure 
reference array. 

The area is for the GETAREA 
reserve pool. 



continued 



4-20 



8600 0478-100 



DUMPANALYZER 



continued 



RESERVEEVENTAREA 



SAVECODEAREA 
SEGDOPE 



SEGSEG 



SIBMARK 



SORTAB 



STACKMARK 



SUPSPACE ARRAY 



STALISTAREA 
UINFOAREA 



The area is space held in 
reserve for the task control unit 
(TCU). The 

RESERVEEVENTAREA is 
passed to the TCU by the 
TCPJ NSTALLEVENTSPACE 
call when the TCU indicates it 
has no unused EVENTS during 
a TCP_ALLOCATE_EVENT call. 
A small pool of the areas is 
maintained by 
R ESER VE_EVENT_ 
AREAMANAGER. 
RESERVEEVENTAREAs are 
currently used only on A 16 
systems. 

This area contains save code. 

The area contains the dope 
vector for a segmented (that is, 
"paged") array. 

The area is a page of a 
segmented array. 

The area contains a DMSII SIB 
created on Mark 3.5 or later 
releases. 

The area contains a sort table 
listing absolute addresses. 

The area contains a stack or a 
segment dictionary. 

The area is a type of array 
subset that is treated as a 
complete unit for 
MASKSEARCH operations and 
primitive memory allocation 
routines. 

The area contains a station list. 

The area is part of the UINFO 
array. 



AREAS RANGE 
< multiple address> 
<output selection > 

<output selection > 



The analysis of memory areas is restricted to the specified 
address range. Areas partially or completely in the desired range 
are analyzed. 

At least one of the following options must be designated: 

CONTENTS The contents of all the selected areas are 

displayed. 
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\ 

LINKS The links of all the selected areas are 

displayed. 

STATS Statistics regarding the memory areas and 

their associated stacks are collected. 
These statistics are reported in a memory 
usage summary. 

Example 

Figure 4-1 shows example output from the AREAS command. 
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INPUT: AREAS RANGE 2100 TO 5000 LINKS 

00p020F5 INUSE AREA DATA: LENGTH=01C20( 7200>M0M ADDR=0001DB96 (THIS IS STACK 012) (STACK) 

LINKS: 6 E01C24 000012 7 000000 000000 3 000000 000000 ... 3 E01C24 000000 

RESCODE MEMORY 

00003019 ..INUSE AREA DATA: LENGTH*04209( 16905 )M0M ADDR=000028A0 (D[0l * 07AD) — — (PERMSAVEAREA) 

LINKS: 6 E0420D 0010D5 7 000000 000000 3 000000 000000 ... 3 E0420D 000000 
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ARRAYLIMIT 

The ARRAYLIMIT command limits the size of each array printed to the number of 
lines specified by the positive < decimal number >. 

<arrayl inrit> 

— ARRAYLIMIT — <decimal number> 1 

If the < decimal number > is O, the printing of arrays is suppressed. 

For multidimensional arrays, the limit is applied cumulatively for both the dope vector 
entries and the data entries. 



ASDNUMBER 



The ASDNUMBER command prints out information about ASDs. 
<asdnumber> 

— ASDN UMBER -^number^ 



L 



UNTIL <number> 
FOR <number> — 
STACK — <number>- 



L 



VIRGIN 



' — EXPAND 



The following text describes the meaning 
ASDNUMBER <number> 

ASDNUMBER <number> UNTIL 
<number> 

ASDNUMBER <number> FOR <number> 

ASDNUMBER STACK <number> 
ASDNUMBER STACK <number> VIRGIN 

EXPAND 



ich variable: 

This form of the command prints out ASD1 
through ASD4 for the specified ASD number. 

This form of the command prints out ASD1 
through ASD4 for the specified range of 
ASDs. 

This form of the command prints out ASD1 
through ASD4 for the number of ASDs 
specified starting at the designated ASD 
number. 

This form of the command prints a list of the 
ASDs for the specified stack. 

This form of the command prints a list of the 
ASDs associated with the specified stack that 
have been referenced but have never been 
allocated an area in main memory for the 
array. 

When the EXPAND parameter is used, the 
ASD 1 through ASD 4 information is printed 
in greater detail. 



Example 

The following is an example of the output from the ASDNUMBER command: 
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INPUT: ASDNUMBER 33 FOR 
ASD1 [00033]: [00040037] 
ASDl_PRESENTTOPROCF 
ASD1_UNALTEREDF 
ASDl_NOTSTACKF 
ASDl_PRESENTFORIOF 
ASDl_NOTPAGEF 
ASD1_READ0NLYF 
ASD1_D0NTRESIZEF 
ASD1_PAGEDF 
ASD1 ADDRESSF 



EXPAND 

630000 022418 
= 1 
= 0 
= 0 
= 1 
= 1 
= 0 
= 0 
= 0 

= 00022418 



ASD2 [00033]: [00068F92] 
ASD2_SPACEUSAGEF 
ASD2 LENGTHF 



3 0A0000 000192 
= 0A (STACK) 
= 00192 



ASD3 [00033]: [00091EED] 
INDEX 
ASDINDEX 



5 E00003 303149 
= 00033 
= 03149 



ASD4 [00033]: [000BAE48] 0 0001D8 003300 



ASD4_STACKSIZEF 
ASD4_0LAYSTATEF 
ASD4_0WNERSTACKF 
ASD4_VIRGINASDF = 0 

ASD4_MARKEDF0RWSSHERI FFF = 0 
ASD4_UNL0CKDISP0SALF = 0 
ASD4 LOCKBITF = 0 



= 0001D8 

= 0 (NON OVERLAYABLE SEG) 
= 033 



TBIT RCWS [00033]: 0 000000 000000 



ASD LOCK STACK 



= 014 



AS Dl [00034]: [00040038] 0 000000 000000 



ASD1 PRESENTTOPROCF 


= 0 


ASD1 UNALTEREDF 


= 0 


ASD1 NOTSTACKF 


= 0 


ASD1 PRESENTFORIOF 


= 0 


ASD1 NOTPAGEF 


= 0 


ASD1 READONLY F 


= 0 


ASD1 DONTRESIZEF 


= 0 


ASD1_PAGEDF 


= 0 


ASD1 ADDRESSF 


= 00000000 



ASD2 [00034]: [00068F93] 6 0A0000 000E28 
ASD2_SPACEUSAGEF = 0A (STACK) 

ASD2 LENGTHF = 00E28 



ASD3 [00034]: [00091EEE] 0 01440F B01102 
ASD4 [00034]: [000BAE49] 6 000 FCC 001201 

ASD4_STACKSIZEF 

ASD4_0LAYSTATEF 

ASD4 OWNERSTACKF 



= 000 FCC 

= 0 (NON OVERLAYABLE SEG) 
= 012 
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ASDTABLEBASE 

The ASDTABLEBASE command displays the base of the ASD table or specifies a new 
< simple address > for future computations. 

<asdtablebase> 

— ASDTABLEBASE -. ■ 1 

<simple address^ 

The following text describes the meaning of each variable: 

ASDTABLEBASE This form of the command displays the base of the ASD table. 

ASDTABLEBASE <simple This form of the command sets the base of the ASDTABLE to the 
address> specified <simple address> for future computations. 

Example 

The following is an example of the output from the ASDTABLEBASE command: 

INPUT: ASDTABLEBASE 

THE BASE OF THE ASD TABLE= 00040004 



ASN 



Note: The ASN command has been deimplemented. This command had 
meaning only on systems with ASN memory, which is not supported 
on Mark 3.9 and later system software releases. 



BOXINFO 



The BOXINFO command prints the box information array. 

<boxinfo> 
— BOXINFO 



-<B0XINF0 cell name>- 
L- # — <offset> 



The following text describes the meaning of each construct: 



BOXINFO 



BOXINFO < BOXINFO cell 
name> 

BOXINFO # <offset> 



Analyzes and prints the contents of the MCP array BOXINFO. 
The BOXINFO array contains global information such as the core 
utilization at the time of the dump. 



The word with the requested cell name or offset is printed. 



Example 

Figure 4-2 shows example output from the BOXINFO command. 
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INPUT: BOXINFO 
BOX INFO DUMP 

BOXINFO ■ 5 800003 103160 



000000 
800001 
800001 
800001 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
800000 
000000 
000000 
000000 
219687 
0000B6 
000000 
000000 
0000A2 
000000 
000000 
000000 
000000 
000000 
000000 



000000 

pss 

103162 
000000 
000FB9 
000000 
0002E3 
0109B7 
0O0C3F 
00179C 
00070A 
02FEA2 
09648A 
03F7E4 
072871 
072291 
000002 
000000 
25056C 
000000 
800000 
020000 
100140 
000000 
000000 
000002 
603165 
000000 
253160 
001052 
BFFEOO 
6607E1 
000000 
000088 
C24FFA 
000000 
000030 
00008F 
000000 
000043 
000000 



BOXINFOZERO 

MA 

SNA 

PMA 

** UNKNOWN WORO 

SCHEOCORE 

NOMEMWORO 

CCOLAY 

PCOLAY 

OCOLAY 

COOLAY 

CLOLAY 

CCWORDS 

PCWOROS 

OCWORDS 

COWOROS 

CL WORDS 

OLAVCHANNELS 

OLAYCLOCKS 

BATCHOLAYDISKSIZE 

SUSPENOEES 

NEMNAX 

MOOSIZE 

ETERNALEVENT . 

(SALADINPIACE2 

ETERNALHEAO 

0NEIRPER80X 

** UNKNOWN WORO * 

HLDDINFO 

8ATCHPBITTIME 

BATCHPBITCOUNT 

INITPBITT1ME 

INITPBITCOUNT 

FREEPBITTIME 

BATCHTASKS 

READYTIME 

SCHEOPROC 

PROCMASK 

INTRINSICSTKNUM 

PLISUPPORTSNRS 

GENERALSUPPORTSNR 

COOEIOCWS 



*AVAILCORE 
= 4025 

» 739 

= 68023 

= 3135 

= 6044 

* 2010 

= 196258 

» 14247050 

= 260068 

= 469105 

= 467601 



2479468 



OLAYCORE 



SAVECORE 



(WAITING: STK 014) 



** UNKNOWN WORD ** 
= 5.8499328 SECONDS 
= 4178 

= 453.594314 SECONOS 
= 3060140001 
FREEPBITCOUNT 



136 

= 6553.54428 SECONDS 

BASICSUPPORTSNRS 
COOEIOCWSAVAILABL 



3600 0473-100 



Figure 4-2. BOXINFO Command Output 



4-27 



DUMPANALYZER 



BYE 

The BYE command terminates DUMPANALYZER. A synonym for BYE is STOP 
<bye> 

— BYE 1 

CAND 

The CAND command analyzes a "candidate" for a port-matching structure. The 
candidate is a subport that has been offered for interprocess communication and has 
not yet found a matching subport. (Refer to the example under "PORT") The CAND 
command is only valid for BNA Version 1. 

<cand> 

— CAND -p<index> . 1 

L_ AT — <address>-l 

The following text describes the meaning of each construct: 

CAND <index> The subport with the indicated <index> is analyzed. The index 

is found in the library info word of the file information block 
(FIB). 

CAND AT <address> The subport at the given <address> is analyzed. 

For more information, see the discussion of the PORT command in this section. 

CB 

The CB command displays the connection block (CB) at the specified < simple 
address >. If the < simple address > is valid and the word at < simple address > + 1 is a 
valid CB identification word, then the memory area is analyzed as a connection block. 

— CB — 1 r-<simple address:*-! 1 

[— AT — ' 

L- VIA — <ASD number> ' 

The following text describes the meaning of each construct: 

CB <simple address> The connection block at the specified address is analyzed. 

CB AT <simple address> 

CB VIA <ASD number> The connection block addressed through the specified ASD entry 

is analyzed. 

An alternative to the CB command is the CB option of the MODE command. The CB 
option causes connection blocks to be analyzed wherever they occur in the output from 
other commands. 

Example 

Figure 4-3 shows example output from the CB command. 
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INPUT: CB AT 269A5C 
— CONNECTION BLOCK ---- 



OOOOOO 
103296 



J00003 
. ICOOOO 
C3C260 C9C4F2 
300002 300002 
OOOOOO 000002 
OOOOOO 70000F 
001000 05000B 
OOOOOO OOOOOO 
OOOOOO OOOOOO 



OOOOOO 
000012 
000121 
000121 
800000 



OOOOOO 
000012 : 
544FA3 : 
537E62 : 
C32964 : 
OOOOOO OOOOOO : 
OOOOOO 000001 : 
-- LINKS TO PCWS 
103296 4C0007 
103296 4C000B 
105062 BCOOOA 
103296 4C000A 
103296 4C0009 



STATUS (STATE'CONNECTED) 
SIRW TO ACTIVATION RECORD MSCW 
IDENTIFICATION 
CB=2/3,CBC>2/3 
ACCESS CODE WORD 
TEMPLATE 

FORMAT (FIXED*0010,LINKS=0005,AR=000B 
GONE COUNT'O 
DISCONNECTION EVENT1 
DISCONNECTION EVENT2 

MY OWNER STACK » 0012, HIS OWNER STACK = 0012 

MY REFERENCE 

HIS REFERENCE 

ACTIVATION RECORD MOM . 

COUNT LOCK (NOT LOCKED 

COUNT = 1 



00,0008 
00 OOOA 
00,0009 
00,0008 
00,0007 
00 0006 
00,0005 
00,0004 
00,0003 
00,0002 
00,0001 
00.0000 



POINTS TO 0008 
POINTS TO 0009 
POINTS TO 0008 
POINTS TO 0008 
POINTS TO OOOA 



ACTIVATION RECORD ANALYSIS 



0001+0007 
0001+0008 
0001 +00 OA 

Oi 



D001+000A 
)001+0009 



ASD 32964 
ASD 32964 
ASD 5062B 
32964 
32964 



IN 
IN 
IN 

IN ASO 
IN ASD 



E00010 045C43 
000493 B0951C 
00002B D09514 
0000C3 30950F 
00011B E0950E 
OOOOOO 909517 
OOOOOO 000001 
OOOOOO OOOOOO 
OOOOOO 000002 
OOOOOO 000001 
2100C8 00550E 
012000 844002 
C00001 544FA3 



*** NOT ALLOWED *** 



PCW 
PCW: 
PCW: 
PCW: 
PCW: 



RCW: 
MSCW: 



LL=2, 
LL«2. 
LL=2, 
LL=2, 
LL=2, 




151C:093B:2. NORML STATE 

1514:02B0:0, NORML STATE 

150F:OC33:0, NORML STATE 

150E:11BE:0. NORML STATE 

1517:0009:0, NORML STATE 



LL=1., NORMAL STATE 
0[06]<:0000 IN STACK 012 



CB REFERENCE 



8600 0478-100 



Figure 4-3. CB Command Output 
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CODEFILE 



The CODEFILE command specifies either the code file or disk family name to be used 
when DUMPANALYZER requires a code file. This command applies only to code files 
that are not MCP code files. 

By default, DUMPANALYZER searches for code files with the same file name and 
family name as on the dumping system, but sometimes this gives erroneous results 
(such as misleading line information). The CODEFILE command can be used to specify 
a correct code file for DUMPANALYZER to use. 

<code file> 

— CODEFILE 



zseg diet stack #> — " - 
FAMILY — <family name>- 



ccode file title; 



The following text describes the meaning of each construct: 



A segment dictionary stack number from the dump. 

A code file title if it is different from the file title on the dumping 
system. 

A family name if it is different from the family name on the 
dumping system. 

CODEFILE returns the code file family, a list of the stack 
numbers, and code file names that are specified. 

If this option is used, DUMPANALYZER uses the specified code 
file whenever it needs access to the code file for the specified 
segment dictionary stack number. This happens when 
DUMPANALYZER converts return control words (RCWs) to line 
numbers or when MODE + IDNAMES has been specified. 

This option causes DUMPANALYZER to search for required code 
files on the specified disk family name. This option overrides the 
family name that the code file had on the dumping system. 

If both options are used, any family name specified in the <seg 
diet stack #> option overrides the CODEFILE FAMILY 
specification. 

Normally, when DUMPANALYZER finds a mismatched code file, it asks for 
confirmation before proceeding. However, if the CODEFILE <seg diet stack #> 
command is being used for the required code file, this confirmation is not required. 
In addition, if the confirmation fails and the user specifies a code file using the FA 
command, DUMPANALYZER behaves as if a CODEFILE <seg diet stack #> command 
was entered with that title. 

Note that when DUMPANALYZER searches for a code file, it searches first without 
using family substitution and then using family substitution. 



<seg diet stack #> 
<code file title> 

<family name> 

CODEFILE 



CODEFILE 

<seg diet stack #> 

<code file title> 



CODEFILE FAMILY 
<family name> 
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CODEINFO (HDU Systems) 

Note: The CODEINFO command has been deimplemented. This command 
had meaning only on systems with address space number (ASN) 
memory, which is not supported on the Mark 3.9 system software 
release and later releases. 



COREMAP 



The COREMAP command analyzes how memory is being used. The user can specify 
which reports and stacks to be analyzed. This command works only for COMPLETE 
memory dumps; it is rejected for PARTIAL or ALLINUSE memory dumps. 

The first time a COREMAP command is entered it creates a disk file called 
MEMDUMP/COREMAP/< date >/< time >, which contains memory information. This 
process requires a scan through memory and takes a few minutes for every million 
words of memory. The ?AX WHERE command can be used to determine the progress 
of this scan. The disk file can be used by subsequent runs of DUMPANALYZER to 
eliminate the need to re-create the screen. 

<coremap> 

— COREMAP 



LAYOUT 
SUMMARY 
USAGE 



DETAIL 

UTQTn 



- STACK <number> - 
L ALL 



■TIT 



The following text describes the meaning of each construct: 



COREMAP HELP 



COREMAP LAYOUT 



COREMAP SUMMARY 



COREMAP SUMMARY 
STACK < number > 

COREMAP SUMMARY 
ALL 

COREMAP USAGE 
COREMAP USAGE 
STACK <number> 
COREMAP USAGE ALL 



COREMAP HELP displays a short description of the various 
subcommands. 

COREMAP LAYOUT displays a map of memory showing the 
amount and location of save, overlay, and available memory. 
Each line of the chart represents 32 K words, with each 
character denoting 512 words. This option also displays a chart 
of the number of occurrences of adjacent areas by type. 

COREMAP SUMMARY displays the amount of save, overlay, 
code, and available memory for the system. 

Displays save, overlay, and code memory for the specified stack. 

Displays save, overlay, and code memory for every stack. 

Displays the number of areas and total words for each kind of 
memory area, such as array, stack, FIB, dope vector, and so 
forth, divided into save and overlay memory. Specifying a STACK 
number analyzes only the memory being used by that stack. 
Specifying ALL displays all stacks. 
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COREMAP DETAIL 

COREMAP DETAIL 
STACK <number> 



COREMAP HISTO 

COREMAP HISTO STACK 
<number> 



The type of memory area in the USAGE reports is the value of 
SPACEUSAGE with the following changes: 



ARRAY 



10 



EVENT 



DATACOM 



MISC 



NORMAL ARRAY (0) AND PERM 
SAVE AREA (22). 

IOCB (6), I0CD(18) AND UINFO 
ARRAY (23). 

EVENT ARRAY (8) AND 
EVENTDOPE (26). 

DATACOM QUEUE (24) AND 
STATION LIST (25). 

SORT TABLE (1 1), SIB (12), ICM 
(21), PROCINFO (27), BOXINFO 
(28), AND RESERVEAREA (29). 



Displays the number of areas and total words for each kind of 
memory area for each size range, such as 1 to 10 words, 10 to 
20 words, and so forth, in a logarithmic progression. Specifying 
a STACK number analyzes only the memory being used by that 
stack. 

The type of memory area in the DETAIL reports is the value of 
SPACEUSAGE except for some changes. See the preceding 
explanation of the COREMAP USAGE command for more 
information. 



Displays a histogram of the number of areas in each size range 
of save, overlay, code, and available memory. Specifying a 
STACK number analyzes only the memory being used by that 
stack. 



DC 



The DC command prints a full data communications analysis. 

<dc> 
— DC 



NSP 



MSG - 1 



The NSP option causes an analysis of the NSP tables to be printed. This analysis 
includes NSP line vectors, NSP line tables, and NSP station tables in addition to the 
DCC table analysis. 

The MSG option causes messages in nontanked data comm queues in the DCALGOL 
queue to be analyzed. 
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Example 

Figure 4-4 shows example output from the DC command. 
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INPUT: OC NSP MSG 



NSP 



DATACOM CONFIGURATION: 
MAXIMUM LSN 
CONFIGURED 



INITIALIZED: 
NSP0107/00 : 

NSP0109/03 : 
NSP0111/04 : 



RELAT VE NSP NUMBER 
RELAT VE NSP NUMBER 
UNIT TAKEN, MAXLINE. 
UNIT TAKEN, MAXLINES=15, 
UNIT TAKEN, MAXLINES=31, 
UNIT TAKEN, MAXLINES=47, 



litis! 



DATA COMMUNICATIONS ANALYSIS 

712 

0, 1, 2. 3, 4 

DCC $NR=06E 
DCC SNR=06D 
DCC SNR=06C 
DCC SNR=06B 



MCS INFORMATION: 

MCSL1J: SYSTEM^COMS 



r STACK=083. PRIMARY QUEUE=0017 
MCS[2]: SYSTEM/dANDE 

. ,STACK*07A. PRIMARY QUEUE=OOOF 
MCS[3]: SYSTEM/ftjE 

_ STACK'DDF, PRIMARY QUEUE=022C 
MCS[4]: SYSTEM/X25 

_ NOT RUNNING. NO PRIMARY QUEUE 
MCS[5]: SYSTEM/DIAgNOSTICMCS 

NOT RUNNING. NO PRIMARY QUEUE 



NO PRIMARY QUEUE 



, ,OIAGNOSTICMCS. 
MCS[6]: RJE/BSC/HASF- 

_ NOT RUNNING, N( 
MCS[7]: SYSTEM/BNAMCi 

STACK»DB4, PRIMARY QUEUE=0029 

DCC STATION TABLE 
LSN 2: ----- NO LINE ASSIGNMENT 



LSN 3: 



LSN 4: 



LSN 5: 



500140 026050 (WRAPAROUND. ENABLED. REAOY , NOT/ATTACHED. MCS«5, MYUSE=IO. WI0TH=80) . 

0001 (C0NTR0LCHAA»4 , '6F\ f*EM0TETYPE = 2 . RETRY = ld, FREQUENCY'100, NIF INDEX=1 
(QUEUES : PR IMARY=n5nE ; CURRENT=N<5NE ; FILE=NONE; PSEUD0MCS=O) 



6F020A 64 

000000 000000 »,.,.. , 

000000 000000 (5L5=N0NE) 

NO LINE ASSIGNMENT 
541040 036050 
6F020A 640002 
840000 017017 



WRAPAROUND. ENABLEO. READY, ATTACHED. MCS=1. MYUSE=I0. WIDTH=80) 
C0NTR0LCHAft=4 6F , l*EM0TETYPE = 2 . RETI$Y = 10 , FREQUENCY=iOO, NIF INDEX = 2) 



0 000000 000000 
--- NO LINE ASSIGNMENT 
0 541040 046050 
0 6F020A 640003 
0 840000 017017 



0 000000 000000 
•-- NO LINE ASSIGN 
0 541040 056050 
0 6F030A 640004 
0 840000 017017 

0 000000 000000 



MCS PARTICIPATES. ALL RESULTS) 

QUEUES: PR IMAR Y=0017 ; CURRENT=0017 ; F1LE=N0NE; PSEU00MCS=O) 
OLS*NONE) 



DEX=3! 



WRAPAROUND. ENABLED, READY, ATTACHED , MCS=1, MYUSE=IO. WIDTH=80) 
C0NTR0LCHAR=4 6F , REM0TETYPE=2 , RETftY=10, FREQUENCY=100, NIF IN 
MCS PARTICIPATES. ALL RESULTS 

QUEUES : PR IMARY=6017 ; CURRENT=0017; F I LE=NONE ; PSEU00MCS=0) 
DLS=NONE 
IENT 

WRAPAROUND. ENABLED. REAOY, ATTACHED. MCS=1. MYUSE=IO. WIDTH=80) 
C0NTR0LCHAR=4"6F\ ftEM0TETYPE=3, RETftY=10, FREQUENCY=iOO, NIF INDEX=4 
MCS PARTICIPATES. ALL RESULTS 

QUEUES: PR IMARY=0017 ; CURRENT=0017 ; FILE=NONE; PSEUOOMCS=0) 
0LS=NONE 
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DCTRACE 



The DCTRACE command displays or prints a summary of the last 250 requests or 
results of the specified network support processor (NSP). These requests or results are 
listed in the chronological order in which they were processed by the DCCONTROL 
stack of the specified NSP; thus, requests and results are interspersed in the summary. 
The summary includes such items as request type, associated logical station number 
(LSN), line number, station number (DLS) and associated error values. 

The DCTRACE option of the ID (Initialize Data Comm) system command determines 
whether the system audits NSP traffic. If the DCTRACE option was not ON at the 
time of the dump, the DCTRACE command in DUMPANALYZER returns the message 
"NSP DOES NOT HAVE A TRACE TABLE". 

<dctrace> 

— DCTRACE — <relative NSP number> 1 



Example 

Figure 4-5 shows example output from the DCTRACE command. 
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INPUT: OCTRACE 0 



OC TRACE TABLE FOR STACK 068 "NSP 107/00" . 



15 


41: 


35 


43358 


REQUEST 


37: 


MAKE STATION READY REQUEST FOR LSN 46 
LENGTH 7 




15 


41: 


35 


53529 


RESULT 


67: 


ACK RESULT IN RESPONSE TO REQUEST NUMBER 
LENGTH 10 


37 


15 


41: 


35 


95994 


REQUEST 


38: 


SET EXTERNAL REQUEST FOR LSN 46 
LENGTH 14 




15 


41 


35 


96039 


REQUEST 38: 


CHANGE STATION EDITOR REQUEST FOR LSN 46 
LENGTH 11 




15 


41 


36.06589 


RESULT 


68: 


ACK RESULT IN RESPONSE TO REQUEST NUMBER 38 
LENGTH 10 


15 


41 


36 


06597 


RESULT 


69: 


ACK RESULT IN RESPONSE TO REQUEST NUMBER 
LENGTH 10 


38 


15 


41 


36 


33219 


REQUEST 


39: 


OUTPUT REQUEST FOR LSN 46, TEXT LENGTH 16 
LENGTH 52 


15 


41 


36 


90996 


REQUEST 


40: 


OUTPUT REQUEST FOR LSN 472, TEXT LENGTH 16 
LENGTH 52 


15 


:41 


37 


01290 


RESULT 


70: 


REJECTED REQUEST RESULT NON-PRESENT STRUCTURE 
LENGTH 10 


15 


•41 


37 


39546 


RESULT 


71: 


ERROR RESULT FROM LSN 46 
LENGTH 36 




15 


:41 


37 


39588 


RESULT 


72: 


STATION NOT READY RESULT FROM LSN 46 
LENGTH 12 




15 


:41 


44 


10962 


REQUEST 


41: 


MAKE STATION READY REQUEST FOR LSN 46 
LENGTH 7 




15 


:41 


44 


11035 


REQUEST 


42: 


MAKE STATION READY REQUEST FOR LSN 46 
LENGTH 7 




15 


:41 


44 


.21132 


RESULT 


73: 


ACK RESULT IN RESPONSE TO REQUEST NUM8ER 
LENGTH 10 


41 


15 


:41 


44 


21170 


RESULT 


74: 


ACK RESULT IN RESPONSE TO REQUEST NUMBER 
LENGTH 10 


42 


15 


:41 


44 


.31115 


RESULT 


75: 


ERROR RESULT FROM LSN 46 
LENGTH 36 




15 


:41 


:44 


.31251 


RESULT 


76: 


STATION NOT REAOY RESULT FROM LSN 46 
LENGTH 12 




15 


:41 


:44 


.31356 


REQUEST 43: 


MAKE STATION REAOY REQUEST FOR LSN 46 
LENGTH 7 




15 


:41 


:44 


.41101 


RESULT 


77: 


ACK RESULT IN RESPONSE TO REQUEST NUMBER 
LENGTH 10 


43 



Figure 4-5. DCTRACE Command Output 
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DEADLOCK 



The DEADLOCK command prints information regarding stacks that hold locks or are 
waiting for a lock. The following items are analyzed: 



• Global locks 

• Header locks 

• Directory locks 

• Userdisk locks 

• Operator reply waits 



If a stack is waiting on any of these items, the stack number is printed. In addition, 
any of the locks that the stack holds are listed. 

All EVENTs and EVENT ARRAYs declared in the MCP outer block are considered, but 
"hard" locks are not reported. 

A stack is reported as waiting for a unit or path only when the stack is actually waiting, 
and not when the stack simply has I/O operations requested. 

<deadlock> 
— DEADLOCK 

J! _ 



h CRITICAL -I 
<number>— 



The following text describes the meaning of each construct: 

DEADLOCK All stacks that either hold locks or are waiting for a lock are 

listed by stack number, along with the names of the events or 
locks. 

DEADLOCK CRITICAL CRITICAL is specified to indicate that only stacks that hold locks 

and are also waiting on locks are to be listed. CRITICAL 
deadlocks might indicate an MCP problem. 

DEADLOCK <number> <number> specifies a particular stack. When a <number> is 

given, only locks for the stack identified by <number> are 
listed. 
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( 

Example 

The following is a sample of the information that is printed regarding stacks that either 
hold locks or are waiting for locks: 

INPUT: DEADLOCK 

LOCK AND WAITING STACK ANALYSIS 



STACK 033 
STACK 037 



STACK 038 



STACK 04C 



WAITING FOR EVENT G 032C ANABOLEVENT 
WAITING FOR EVENT G 0B93 NET_EVENTSW[0005] 
WAITING FOR EVENT G 0B93 NET_EVENTSW[0001] 
WAITING FOR EVENT G 09AC PSE[000F] 
WAITING FOR EVENT G 09AC PSE[000F] 
WAITING FOR EVENT G 09 AC PSE[0006] 
WAITING FOR EVENT G 09AC PSE[0005] 
WAITING FOR EVENT G 09AC PSE[0006] 
WAITING FOR EVENT G 09AC PSE[0005] 
WAITING FOR EVENT G 1B98 SLOGMONITOREVENT 



DEBUG 



The DEBUG command dynamically sets, disables, or interrogates the DEBUG option. 
If DEBUG is set, a program dump is produced to aid in debugging DUMPANALYZER. 

<debug> 
— DEBUG 



I— + 

The following text describes the meaning of each option: 

DEBUG Sets the DEBUG option. This is a synonym for for DEBUG + . 

DEBUG + Sets the DEBUG option. 

DEBUG - Disables the DEBUG option. 

DEBUG ? Shows whether or not the DEBUG option is set. 



Example 

The following DEBUG command sets the DEBUG option: 
DEBUG + 

DEBUG SET 
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DESCANAL 



The DESCANAL command performs a descriptor analysis for all descriptors and in-use 
areas in the dump. 

<descanal> 

— DESCANAL -, ■ 1 

L_ ORPHANED -I 

The following text describes the meaning of each option: 

DESCANAL Displays the location of all in-use areas of the dump, all 

descriptors containing an address in the area, and miscellaneous 
descriptors that cannot be associated with a specific area. 

DESCANAL ORPHANED Displays areas for which no descriptor could be found and all 

miscellaneous descriptors. 

Example 

Figure 4-6 shows example output from the DESCANAL command. 
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O 



o 
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2 

z 
> 

N 

m 



era 

2 INPUT: OESCANAL 

n AODRESS OOOOOOOO NOT PART OF A DUMPED MEMORY AREA 

^ SORTING 1 DESCRIPTORS 

<n DESCRIPTOR ANALYSIS 

IN-USE AREAS = 0, DESCRIPTORS PRESENT * 1 

O AR E* LENGTH LOCATION DESCRIPTOR LOCATION DESCRIPTOR LOCATION DESCRIPTOR LOCATION DESCRIPTOR 
BEGIN MISC DESCRIPTOR DUMP 



8 



> - - ENO MISC. DESCRIPTOR DUMP 



#PERM SAVE = 1 #TEMP SAVE « 0, #OVERLAY = 0 



O 
o 

3 

3 

03 
3 
Q. 

o 

c 

r-f 

c 



00 

m 
o 
o 
o 

^1 

CO 

I 
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DISKFILE 



The DISKFILE command routes the subsequent output to the user-specified disk 
output file. 

<disk f i 1 e> 
— DISKFILE 



L " — <f i 1 e title: 



The following text describes the meaning of each construct: 



DISKFILE 



DISKFILE "<file title>" 



DISKFILE ? 



The DISKFILE command routes the subsequent output to the 
disk output file previously specified by the user. If there is no 
output file available, an error message is displayed. This 
command switches the output mode from remote or printer to 
the disk file provided that a disk output file is available. 

The "<file title>" option of the DISKFILE command causes 
DUMPANALYZER to use the given file title as the disk output file 
and to route the subsequent output to it if no disk output file 
exists. If there is a disk output file available, an error message is 
displayed. The RELEASE DISKFILE command should be used in 
this case to release and save the current disk output file before 
assigning another disk file. See the RELEASE command for 
information on releasing and saving a disk output file. 

The question mark (?) option of the DISKFILE command can be 
used to find the name of the current disk output file. 



For more information, see the discussion of the following commands in this section: 



• RELEASE 

• REPEAT 

• SHOW 



FIB 



The FIB command analyzes a file information block (FIB) that starts at an arbitrary 
address and prints the results. 

Text contained in buffers is printed unconditionally. 
<fib> 



— FIB — i 1— <simple address>- 

!— AT — I 

VIA — <ASD number> 



The following text describes the meaning of each construct: 
FIB <simple address> 

FIB AT <simple The FIB starting at <simple address> is analyzed and the 

address> results are printed. 



continued 
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continued 

FIB VIA <ASD number> The FIB located at <ASD number> is analyzed and the results 

are printed. 

Example 

Figure 4-7 shows example output from the FIB command. 
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INPUT: FIB VIA 33 



0 00 

1 01 
02 
03 
04 
05 
06 
07 
08 
09 
OA 
OB 
OC 
00 
OE 
OF 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
1A 
IB 
1C 
10 
IE 
IF 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
2A 
28 
2C 
2D 
2E 
2F 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
3A 
3B 
3C 
3D 
3E 



000002 
033000 
000000 
000000 
800000 
000000 
033000 
000000 
OOQOOO 

0 000000 
5 000000 

000000 
000000 
000000 
000000 
000000 
000000 
270001 
000338 
000000 
012000 
020290 
000000 
000000 
000027 
000000 
000000 

cooooo 

800000 
C00005 
C00004 
800030 
012000 
010201 
012000 
000000 
000000 
0OO33B 
000812 
000000 
000846 
000000 
000000 
000000 
000000 
3E6858 
000000 
000000 
000893 
000812 
000000 
000000 
012000 
010200 

1 033002 
0 000000 

000000 
000812 



0 
0 

1 012000 



012000 
010409 
1 033002 
1 012000 



B00006 
040000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
400000 
000000 
004608 
000000 
000000 
000000 
000000 
2418E8 
1C8011 
002000 
844002 
0890E4 
000000 
000006 
606500 
000000 
000000 
50765A 
30470B 
B05383 
F1CBA6 
000800 
84400C 
6050E8 
84032C 
000001 
000000 
1C8005 
D8501E 
000000 
7FB37E 
0O074A 
000000 
000005 
000012 
074A30 
000005 
000033 
F0101E 
D0101E 
0016E6 
000000 
844008 
F85A44 
540001 
000000 
000000 
D0101E 
840000 
844007 
B85022 
040000 
840000 



SELECTOR 
FIBMSCW 
FIBLOCK 
RECORDSTATUS 
FILESTATUS 
TANKDATA1 
TANKDATA2 
DISKBLOCK 
PAGESPEC 
IOINFO 



LEVEL=8. ALGOL, BUFFER' 
FILETYPE=O.UNIT*WORD$] 
PHYSICAL: BL0CKSI2E=8l 



SEGPERBLK-O. RECPERBLK=(J ) 



0, NOTOPENEO STATE) 

MINRECSI2E=0, MAXRECSIZE=0) 



. .... , ( KIND=UNASSIGNED] 

LEB (LEB BLOCK SHOWN BELOW 



IN HEX) 

IOAREA 
BUFFDESC 
SIOAREA 
FMTBUFFOESC 
FMTLOCK 
SELFDESC 
PWRITES 
PREADS 
PWRITEN 
PREAON 
PSEEK 
PINITIATE 
PSEARCH 
PLOCKER 
PRELEASE 
PMOVEOUT 
PMOVEIN 
PWAIT 
PFLOAT 
PCWCONTROL 
RECOFF 
RECORDCOUNT 
BLOCKCOUNT 
LOWER 
UPPER 
MINRECSZ 
RECSIZE 
I 
T 

AEXP 
OHEAOER 
FIBEOF 
ACTNUM 
SBLOCKING 
S 10 INFO 
SOFFSET 
CURRENTBLOCK 

HLEEVENTl (LOCKED/CONTENOED BY STK 008 9 13F0:101E:0 (78747500) CL0SE1STREEL OF LMGUTS) 

OUTPUTTRANSLATION 

INPUTTRANSLATION 

USEROUTINES 

FLOPPYMISC (N0RMALI0LENGTH=4128 ) 

FIBLOCKSNR 

IOCB 

TRANSACT I ONCOUNT 
L IBRARYINFO 

RMM^HYSICALIOCOUNT (READ = 73728, WRITE = 8650752) 

MONITORWORD 

BUFLINKS 

IOMOM 



(E0FU=0, EOFV=0) 
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FINDIOCB (EMS Systems) 



The FINDIOCB command is used to find I/O control blocks (IOCBs) in a memory 
dump, and is valid only for EMS systems. The user can set various options to narrow 
the scope of the search and cause DUMPANALYZER to display only the IOCBs that 
satisfy those options. 



<findiocb> 
— FINDIOCB 



r 



-/1\- VIA ASD 
:number>- 



<number>- 

— TO — <number>- 



KEY 



L /l\- RANGE — <multiple address^ 
-<number>— ' 



Note: The <number> option refers to a word in the IOCB and must be a 
hex value from 0 up to the last IOCB word. 

The following text describes the meaning of each construct: 



FINDIOCB 



FINDIOCB VIA ASD 



FINDIOCB <number> 



FINDIOCB 

<number>-<number> 

FINDIOCB <number> 
TO <number> 

FINDIOCB RANGE 
<multiple address> 

FINDIOCB :KEY 
<riurriber> 



All of system memory is searched for the pattern "IOCB" in bits 
[47:16] and a 0 in the Tag. Each match is then analyzed and 
displayed. 

The ASD table is searched for in-use memory areas with an 
ODDBALL field of 6 (IOCB). This method is faster than searching 
all of memory, but might miss some IOCB areas that were 
returned to the system shortly before the dump. 

Only the word with the specified number of each IOCB found is 
analyzed and displayed. 



IOCB words in the range <number> through <number> are 
analyzed and displayed. 

System memory within the specified address range is searched 
for IOCBs. 

IOCBs that are found where word <number> masked by the 
DUMPANALYZER MASK value matches the DUMPANALYZER 
PATTERN value. These IOCBs are then analyzed and displayed. 
(See the discussions of the MASK and PATTERN commands for 
more details.) 



Examples 

The following command displays an analysis of words 0, 3, A, B, C, D, E, and F in each 
IOCB that is found: 



FINDIOCB 0 3 A-F 
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The following command displays an analysis of words 3 and 5 of all IOCBs found from 
absolute address 90AAA through 92AAA. IOCBs are found by means of the ASD table. 

FINDI 3 5 RANGE 90AAA to 92AAA VIA ASD 

The following command examines all IOCBs found from absolute address 9A000 
through 9B000. If word 2 of an IOCB masked with the system MASK value matches 
the system PATTERN value, then words 1 through 4 and A through E of that IOCB are 
analyzed and displayed. IOCBs are found by means of the ASD table. 

FINDI VIA ASD 2 A TO E 1-4 R 9A000 to 9B000 :K 2 

The following is an example of output from the FINDIOCB command: 

INPUT: FINDI 3 RANGE 15000 TO 20000 VIA ASD 
********************************************* 

IOCB AT 0001E727 (ASD# =0214E) 

WORD # 03 SELF PTR: 5 C00002 00214E 

********************************************* 

IOCB AT 0001EDC4 (ASD# =0247B) 

WORD # 03 SELF PTR: 5 C00002 00247B 

*********************************** 

2 VALID IOCBS WERE FOUND. 
*********************************** 

FINDSTACKS 

The FINDSTACKS command produces a list of all stacks containing an environment 
for a specified global procedure name in the MCP DO stack. 

<findstacks> 

— FINDS TACKS — <global procedure name> 1 

Example 

The following is an example of the output from the FINDSTACKS command: 
INPUT: FINDSTACKS INTERLOOPER 

STACKS WHICH CONTAIN AN ENVIRONMENT FOR INTERLOOPER: 
02B 02C 02D 02E 

GC (EMS Systems) 

The GC command displays the configuration of the system at the time of the dump. 
The resources of the system and information about the I/O subsystem are given, 
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including all DLPs base by base for all bases and DLPs configured at the time of the 
dump. The GC command is valid only for dumps from EMS systems. 

<gc> 
— GC 



L<simp1e address>— 1 j-— 0' 



OVERRIDE 



3 



The following text describes the meaning of each construct: 



GCand 

GC <simple address> 



GC OVERRIDE 

GC <simple address> 
OVERRIDE 

GC <simple address> 
OVERRIDE 



Memory starting at the address of the descriptor located at 
<simple address> is analyzed as a configuration file. If no 
<simple address> is given, the address where the 
CONFIGURATION global descriptor is located is used by default. 



If word 1 of the memory area analyzed does not contain the 
EBCDIC word CONFIG (indicating a valid configuration), the 
error message "Configuration location must be specified" is given 
unless the OVERRIDE option is selected. The OVERRIDE option 
causes the memory area to be analyzed as if it were a 
configuration file even if word 1 lacks the correct marker. 



Example 1 

INPUT: MD G CONFIGURATION 

8024F (00000) 5 800030 C8B275 
Entering GC or GC 8024F causes the configuration to be analyzed. 
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Example 2 

The following is an example of the GC command display and an explanation of some of 
its terminology: 

INPUT: GC 

***** GROUP CONFIGURATION ***** 
GROUP ID: DEFAULT 
PROCESSORS: 

PROC ID. 9; 
PROC ID. 10; 
OPERATIONS: 

DL BACKUP PRINTS; 
DL LOG SCRATCH48; 
DL USERDATA 39; 
DL JOBS CRONUS; 
DL CATALOG PS; 
DL OVERLAY 504 SCRATCH49; 
DL SORT CRONUS; 
DL DPFILES SCRATCH48; 
DL IPFILES CRONUS; 
HN SFA6AB; 
PERIPHERALS ALLOWED TO GROUP: 

2,3,17-29,32,44-69,75,80-181,183,184,187-235,237,240-255; 
I/O: 

BASE 0/1/0 

IOP 1 % PORT 0 LEMPORT 0 
ADDRESS 0 DLPID 1 0DT2 
ADDRESS 1 DLPID 243 NSP5 
ADDRESS 3 DLPID 76 MT6 
ADDRESS 4 DLPID 112 NSP5 
ADDRESS 5 DLPID 44 SCSI1 
ADDRESS 6 DLPID 20 TP5 
ADDRESS 7 DLPID 28 MT1; 
BASE 0/2/0 

IOP 2 % PORT 0 LEMPORT 0 
ADDRESS 1 DLPID 157 ICP1 
ADDRESS 2 DLPID 236 IPFIPS1 
ADDRESS 5 DLPID 68 SCSI1; 



The following text describes the meaning of elements that commonly appear in the GC 
output: 



PROC ID. 
PATH 

IOP 

LEMPORT 



A unique number identifying a host processor 

A description of the unique path from a host to the DLP of a 
unit. The path consists of an I/O processor (IOP) and a line 
expansion module (LEM) port. 

The relative I/O processor (IOP) that the path traverses. (There 
can be up to eight ports per processor.) 

The relative line expansion module (LEM) port that the path 
traverses. 
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continued 



BASE 



A description of the base in which the DLP of the unit resides. 



DEPENDENT HOST 



If a path to a unit or units is through an outboard host (such as 
an NSP), a description of the outboard host. 



GRAPHS 



The GRAPHS command causes MCP stack graphs to be printed one level deep. 
<graphs> 

— GRAPHS -, . 1 

<number>— ' 

The following text describes the meaning of each construct: 

GRAPHS All MCP stack graphs are printed one level deep. 

GRAPHS <number> The graphs for the stack identified by <number> are printed. 

Example 

The following is an example of the output from the GRAPHS command: 
INPUT: GRAPHS 36 

GRAPHS STACK 036 = *SYSTEM/DRCSUPPORT. 

PASSIVELIBGRAPH .... 012 = *SYSTEM/MCP/39019F ON DISK. (1) 
PROGRAMDUMPGRAPH ... 039 = *SYSTEM/DRCSUPPORT ON DISK. (1) 

012 = *SYSTEM/MCP/39019F ON DISK. (1) 



The HARDINFO (Hardware Information) command displays various system state 
registers and data. HARDINFO is valid only when analyzing a standalone tape dump 
from an RMM system. 

<hardinfo> 

— HARDINFO 1 

Example 

Figure 4-8 shows example output from the HARDINFO command. 



HARDINFO (RMM Systems) 



4-48 



8600 0478-100 



DUMPANALYZER 



INPUT: HAROINFO 
IOP 1 IS DISTINGUISHED 
TCP 1 IS DISTINGUISHED 
ITC 4 IS DISTINGUISHED 
PROCESSOR 4 

IN STACK 037 F=OO00OOO2376C 

FAIL INFORMATION 



S=0OOO0OO23774 LL=1 9 1021:OC47:4 CONTROL STATE 



HALT REASON IS 0: UNC HALTED 
SWITCH SETTINGS: 
ERROR HALT IS ON 
OPERATOR DEPENDENT HALT IS OFF 
CONDITIONAL HALT IS OFF 
INSTRUCTION HALT IS OFF 



TCP CPMS STRUCTURE 
CPM 4 

CPU STATE 



(RESERVED) 
CURRENT STACK 



000000000003 
000000000000 
000000000037 
000000000035 
0000435EBE86 
FBOO00O22D52 
FFOOOOOOOOOO 



NEXT STACK 
ACTIVE TIME 
IDLE TIME, 
(RESERVED) 

CPMLINK/PRIORITY 0OOO0OOA19OO 
PREFERRED STACK 00000000002B 
HELD STACK 000000000000 
CPM REQUESTTIME 00004362E980 
CPM SAVE TIME 000000000000 
REJECTION TIME 00004221F2BD 
SELECTED STACK 000000000035 
MIC CNTRL WORD OA0000000010 
CONTINUE COMMAND 8F20E1000000 

MSM 1 

PRESENT MSU BOARDS: 0 12 8 9 
ENABLED MSU BOAROS: 0 12 8 9 
TO BE SAVED MSU BOAROS: NONE 
MSM FAIL REGISTER INFORMATION 

SCHED A: 0 000000 000400 0 000000 0001A4 

SIM 0: 0 000000 OOOOEO 0 000000 1E5883 

SIM 1: 0 000000 OOOOEO 0 000000 345881 

CONSOLE ERROR LOG ANALYSIS 
(ANALYZE SUMLOG FOR MORE DETAILS) 
LOAD REPORT : FORCE DUMP 



NO ERRORS 
NO ERRORS 
NO ERRORS 



Figure 4-8. HARDINFO Command Output 
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HDR 



The HDR command analyzes the disk file header stack or a particular header and 
prints out that analysis. 



<hdr> 
— HDR 



- SUMMARY 

- ROWS — 
— <number>- 



- " — <file title; 
JOB <number> — 



I- ROWS 
RAW - 



The following text describes the meaning of each construct: 



HDR 

HDR SUMMARY 

HDR ROWS 

HDR <number> 

HDR <number> ROWS 

HDR <number> RAW 

HDR "<filetitle>" 
HDR JOB <number> 



The HDR form of the command prints an analysis of all the file 
headers that existed in memory when the dump was performed. 
Row address words are not printed. 

The HDR SUMMARY form of the command prints a list 
containing the location and names of all the headers that existed 
in memory when the dump was performed. 

The HDR ROWS form of the command produces a printout with 
all the information that the HDR form produces plus an analysis 
of the row address words. 

The HDR <number> form of the command prints the same 
information as HDR, but only for the header specified by 
<number>. 

The HDR <number> ROWS form of the command prints the 
same information as HDR ROWS, but only for the header 
specified by <number>. 

The HDR <number> RAW form of the command produces a 
printout in hex format of the entire header specified by 
<number>. 

The <file title> form of the command causes the header stack 
to be searched and the requested header printed if it is located. 

The JOB <nUmber> form of the command causes the header 
stack to be searched and the requested header is printed if it is 
located. 



Example 

Figure 4-9 shows example output from the HDR command. 
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(PHOEBE)EDIT0R/OPTIOt 
AT 5 800002 516851 I 
= 0 001004 A015E6 



0000 
0001 

0002 
0003 
0004 
0005 

0006 
0007 
0008 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 



3F3F04 A015E6 
0010C0 C12000 

000000 000000 
001EOO 00001E 
4E4760 2A3215 
63000A OOOOOA 

000001 000000 
080382 500000 
01901F 01D001 
000000 000002 
4E475F DD02D2 
4E475F OD0202 
4E475F D00202 
000000 000000 
000000 1A02D4 
800000 008400 
001000 000000 
000000 000000 



S ON ASO" , 
LENGTH = 37) 
ECORO SIZE 



NAME 

37, IOC 



(PH0EBE)EDITOR/0PTIONS ON ASO 
ATION = 5606, BASE UNIT = 29 



IVATE, SECURITYUSE » I/O, MODE = SHARED 



BLOCKLENGTH = 37. LOCATION =5606 
OPENCOUNT = 1 , FILEKIND = 192 (DATA), PERMANENT, WRITTEN ON, FIXED SIZE 
AVAIL SPACE — n 

EXTMOOE = SINGLE, UNITS = WORDS , FILETYPE = 0 
BLOCKSIZE = 30, MINRECSIZE = 0, MAXRECSIZE * 30 
TIMESTAMP (OATt = 90039. TIME = 17:12:33.6682) 
VERSION = S. SECUR I TYTY^E * PRIV" 
ROWS = 10. ROWSIZE = 10 

iff M A/W f jA| S ¥SR|'§¥ 5 |-8- p E p§'?{S85{?!!.- F f2?ii^f?JS?S 0 

s{ife e igP5 x .-o \\iW kin 11 , i "• 8AseuSit ■ ustu " it = 1 

CREATION TIME§TAMP (DATE = 90039, TIME * 
ALTER TIMESTAMP (DATE = 90039 TIME = 
ACCESS TIMESTAMP DATE = 90039 TIME = 
MULT I USE WORD 

ORIGHDRVERSION = 0, CONTENDQRS * 0, CORE INDEX 



17:09: 
17:09: 
17:09: 



19.4269 
19.4269 
19.4269 



2D4 



FILESTRUCTURE = AL I GNED180 (BY DEFAULT), SECTORSlZE 
DRCINFO FAMILYLISTINDEX = 0( INVALID). OACUSERCOUNT • 
NOT USED 



180 



NUMBER OF ALLOCATED ROWS = 1 
OPTIONAL ATTRIBUTE WOROS: 

0000 0 800000 000000 AVAILABLE 

0001 0 800000 000000 AVAILABLE 

0002 0 OOOEOO 0007FF ATTNO = 14 ( 

VALUE : 0000 



** UNKNOWN **). TYPE 
I07FF (OEC) : 2647 
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HEADING 



The HEADING command causes the heading (first page) of a dump to be printed at the 
terminal or line printer. 

The information provided in the header includes the title of the MCP, the cause of the 
memory dump, and the processor that initiated the dump. 

For an enhanced memory dump, a title displaying "< machine type> <dump type> 
MEMORY DUMP" is shown. In this title, <machine type> is the name of the 
machines, and <dump typo can be COMPLETE, ALLINUSE, or PARTIAL. 

<heading> 

— HEADING 1 

Example 

The following is an example of the information returned by the HEADING command: 
INPUT: HEADING 

DUMPANALYZER Version: 39.42.280, SDASUPPORT Version: 39.40.44 
********************************** 

* A15 COMPLETE Memory Dump * 

* (System Serial : # 8) * 

* A15 MCP: MARK 39. 23.3353 * 

* 3/23/90 20:59 * 

* This is an analyzed dump from DISK: * 

* *MEMORY/SAVEDUMP/9002082010 ON MCP* 
***************************************** 

Clock: 0003870E89EE (10:06:01 Since HALT/LOAD) 

Actual Clock: 0007555BCFA4 (20:59:52) 

Hostname: MPA15C 

Dumping MCP: . *SYSTEM/MCP/39023A ON DISK. (MCP/AS) 

Creation Timestamp: 03/22/90 22:43:08 
Intrinsic Name: (NOT SPECIFIED) 

Cause of NONFATAL Dump: FAULTED MCP CODE 
Memdump called G> 1109:0111:1 (21074000) PROCESSKILL 

Memory dump performed by: Processor Bin Stack 7DB S=>001EE589 

Processor 4 in Stack 0F5 S=>001C2F03 
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The following are the meanings of selected items in the HEADING command output: 
Item Description 

Memdump called @ This item specifies the segment and relative address 

where memdump was called. 

Memory dump performed by This item specifies the processor that initiated the 

dump, the stack number in hexadecimal, and the S 
register setting. Any other active processors are then 
printed with their stack numbers and S register 
settings. 

When the memory dump procedure is invoked, it 
"seizes" all processors with a processor-to-processor 
interrupt. This information indicates the position of 
the processors at the time they were seized. 



HEAP 



The HEAP command displays information about the heaps in use by a Pascal process. 
Before the HEAP command is used, the HEAPSTACK command must be used to 
specify the target process stack. 



HEAP 



:heap number 



>J 



-<heap pointer>- 



L FOR -r-<length: 
L- SIZE - 



<heap pointer> 

— <Pascal pointer>- 



:skip value 



>J 



The <heap number>, <length>, and <skip value> constructs are each <hexadecimal 
number>s. 

The following are the meanings of each of the elements of the HEAP command: 



HEAP 

S <heap number> 
<heap pointer> 



If entered without parameters, this command displays information 
about all the heaps in use by the process stack. 

Specifies a separate heap that the <heap pointer> is applicable to. 
If the S <heap number> clause is not used, or if the <heap 
number> specified is 0, the nonseparate heap is displayed. 

Causes the display to begin at the specified point in the heap. 

For separate heaps, the <heap pointer> is a row index into the 
dope vector for the separate heap. For the nonseparate heap, the 
<heap pointer> is a word offset into the heap array. 

If the <skip value> is included, it specifies an offset, in words, 
from the < Pascal pointer>. The display starts at the specified 
offset. The <skip value> cannot skip past the end of a separate 
heap entry or beyond the end of a nonseparate array row. 



continued 
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continued ^ 

\ 

FOR Specifies the number of words to display. If no FOR clause is 

included, a single word is displayed. 

If the FOR <length> clause is used, then <length> specifies the 
number of words to be displayed. The actual number of words 
displayed is the minimum of <length> and the number of words 
remaining in the row after the <heap pointer>. 

If the FOR SIZE clause is used, the structure of the heap determines 
the number of words displayed. For separate heaps, the size is the 
row size of the specified heap, minus any specified <skip value>. 
For the nonseparate heap, the size is the number of words in the 
heap page, minus any specified <skip value>. 



Examples 

The following is an example of the output from a simple HEAP command for a process 
stack that is using only the nonseparate heap: 

INPUT: HEAP 

NON SEPARATE HEAP ROWS 0 - 19 IN USE, TOP OF HEAP IS 196F1B 
SYSTEM PAGE SIZE IS 100 (256) WORDS 

The remaining HEAP examples show the progressive analysis of a single process stack 
that uses multiple separate heaps. The following is the output from a simple HEAP 
command for this process: 

INPUT: HEAP 

A (10) SEPARATE HEAPS IN USE 



# 1 @ 22, TOP 

# 2 @ 23, TOP 

# 3 @ 24, TOP 

# 4 G> 25, TOP 

# 5 <s> 26, TOP 

# 6 <<> 27, TOP 

# 7 G> 28, TOP 

# 8 @ 29, TOP 

# 9 @ 2A, TOP 

# A @ 2B, TOP 



80, FREE HDR: 7E, MAX SIZE: FFFFF, 100 OF AB WORDS 

0, FREE HDR: -1, MAX SIZE: FFFFF, ABSENT 

53, FREE HDR: -1, MAX SIZE: FFFFF, 100 OF 9 WORDS 

89, FREE HDR: 7A, MAX SIZE: FFFFF, 100 OF 6 WORDS 

2, FREE HDR: 1, MAX SIZE: FFFFF, 100 OF 2AAE WORDS 

30, FREE HDR: 2D, MAX SIZE: FFFFF, 100 OF 12 WORDS 

6F, FREE HDR: 3D, MAX SIZE: FFFFF, 100 OF C WORDS 

0, FREE HDR: -1, MAX SIZE: FFFFF, ABSENT 

5A, FREE HDR: -1, MAX SIZE: FFFFF, 100 OF 8A WORDS 

2, FREE HDR: 1, MAX SIZE: FFFFF, 100 OF 6 WORDS 



SYSTEM PAGE SIZE IS 100 (256) WORDS 

The following are the meanings of various elements in the previous example: 
# xx Heap number, 1 through nn 

@ yy Offset of descriptor from bottom of stack (BOSR) 

TOP: Current top of heap marker 

FREE: Head of free list within heap. A value of -1 means the free list is 

empty. 

MAX SIZE: Maximum number of entries allowed in heap 

continued 
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continued 



ABSENT: 



Heap not yet used 



22 of aa WORDS 



22 rows (entries) of si2e aa words each 



The following command attempts to display row 100 in separate heap 0: 

INPUT: HEAP S 0 100 

NON SEPARATE HEAP IS NOT AVAILABLE 

Because separate heap 0 does not exist, DUMPANALYZER attempts to display word 
100 of the nonseparate heap. Because there is no nonseparate heap for this process, 
DUMPANALYZER returns the error shown. 

Figure 4-10 shows the output from several commands that analyze separate heaps 
associated with the same process stack. 
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INPUT: MD STK 93E BOSR + 2B 
OOOD5C73(OOOOOO0O) 5 800010 0104A4 

: READY 

INPUT: MD VIA 104A4 FOR 100 

OOOB32C4TOOOOOO0O 1 5 800000 610CCE 5, 800000 6139E3 5 000000 600000 5 000000 600000 5 000000 600000 5 000000 600000 

OOOB32CA(00000006) 5 000000 600000 THRU OOOB33C3( OOOOOOFF ) 

: READY 

INPUT: MD VIA 10CCE FOR 6 

OO22A538(OOOOOO0O) 3 4EFC63 468848 3 000807 30E3EF 3 400000 000001 3 4EFC63 460482 3 000803 90E3F0 0 C4C9E2 D7E9C4 
:REAOY 

INPUT: HEAP S A 0 FOR SIZE 

O022A538(OOOOOO0O) 3 4EFC63 468848 3 000807 30E3EF 3 400000 000001 3 4EFC63 46D482 3 000803 90E3FO 0 C4C9E2 D7E9C4 
:REA0Y 

INPUT: MO VIA 139E3 FOR 6 

OOOFD356(0OOOOO0O) 3 4EFC63 796699 3 000807 30E3EF 3 000000 000000 3 4EFC63 79A5B5 3 000803 90E3F0 0 C4C9E2 D7E9C4 
:REA0Y 

INPUT: HEAP S A 1 FOR SIZE 

OOOFO356(OOOOOO0O) 3 4EFC63 796699 3 000807 30E3EF 3 000000 000000 3 4EFC63 79A5B5 3 000803 90E3F0 0 C4C9E2 D7E9C4 
INPUT: HEAP S 3 1 FOR SIZE 

001EF936(00000000) 3 4EFC63 10C1FB 3 000808 91238C 0 35C5E6 7DC440 0 001300 011C04 0 0CF0F8 FOFOFO 0 C2F0F0 F0F2F9 
001EF93C(00000006) 0 F2C5E6 70C440 0 D5C5E6 7DC440 0 D5C5E6 7DC440 "ruru 
:REAOY 

INPUT: HEAP S 3 1+2 FOR SIZE 

OOlEmEioOOOOoSei 0 D5C5E6 70C440 ° 001300 011C04 0 0CF0F8 FOFOFO 0 C2F0F0 F0F2F9 Q F2C5E6 7DC440 0 05C5E6 7DC440 
:READY 

INPUT: HEAP S 3 1+2 FOR 3 

001EF938(00000000) 0 35C5E6 7DC440 0 001300 011C04 0 0CF0F8 FOFOFO 
: READY 



DUMPANALYZER 



The following are notes about the commands shown in Figure 4-10: 



MDSTK93E BOSR + 2B 



MD VIA 104A4 FOR 100 



MD VIA 10CCE FOR 6 



HEAP S A 0 FOR SIZE 



MD VIA 139E3 FOR 6 



HEAP S A 1 FOR SIZE 



Displays the stack cell containing the descriptor for heap A. 
The heap is identified by its offset of 2B; this offset appears 
in the output for the simple HEAP command shown 
previously. The simple HEAP command also shows that 
heap A can hold FFFFF entries, and that currently space for 
100 rows of size 6 words has been allocated. The top of 
heap value is 2, indicating the next nonallocated row that 
can be used. The free header is 1, which means that the 
row at index 1 has been disposed and is in the free chain. 

Displays the contents of the dope vector of the heap. The 
address of the dope vector, 104A4, was taken from the 
output of the previous command. It can be seen that only 
rows 0 and 1 have been used. 

Displays the contents of row 0 of separate heap A. The 
address of the row descriptor, 10CCE, was derived from the 
first word of the dope vector for heap A. 

Because the process was executing a Pascal program 
compiled with the HEAPDEBUG option set, several words of 
trace information appear at the start of the row; these are 
the tag 3 words. The following are their meanings, in order: 

• The first word is the timestamp of the NEW call that 
last returned the row for program use. 

• The second word is the return control word (RCW) 
where the NEW call was made. 

• The third word is the free list link. Note the free list link 
of-1. 

• The fourth word is the dispose timestamp. 

• The fifth word is the return control word (RCW) where 
the DISPOSE call was made. 

The third, fourth, and fifth trace words appear only for rows 
that are disposed. 

Displays row 0 of separate heap A. This HEAP command 
displays the same information as the previous MD 
command, but is easier to use. That is, the HEAP command 
can be used without examining the heap descriptor and 
dope vector first. 

Displays the contents of row 1 of separate heap A. The 
address of the row descriptor, 139E3, was derived from the 
second word of the dope vector for heap A. Like row 0, row 
1 is disposed and includes five words of trace information in 
the order described for row 0. Note the free list link of 0. 

Displays row 1 of separate heap A. This is the same area as 
that displayed by the previous MD command. 

continued 
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continued 



HEAP S 3 1 FOR SIZE 



HEAP S3 1+2 FOR SIZE 



HEAP S3 1+2 FOR 3 



Displays the row at index 1 in heap number 3. This is a 
nondisposed area. The amount of memory displayed is the 
size of the row; that is, the size of the record type that is in 
this heap. 

As discussed previously, the row contains trace information 
in the tag 3 words. Because the row is not disposed, only 
the first two tag 3 words appear: the timestamp of the last 
NEW call and the RCW for the NEW call. 

Displays the row at index 1 in heap number 3. The first two 
words, storing the trace information, are omitted. The 
amount of memory displayed is equal to the size of the row 
minus two, for the words that are omitted. 

Displays the same information as the previous command, 
except that the output is limited to 3 words. 



HEAPSTACK 



The HEAPSTACK command specifies or displays the process stack and the heap offset 
used by the HEAP command. 

The heap offset is measured relative to the mark stack control word (MSCW) at lex 
level 2 in the process stack. The default heap offset is 2, but the actual heap offset can 
vary depending on whether the program contains modules and depending on the 
version of the Pascal compiler used. 

— HEAPS TACK -> , * 

I— <hexadecimal stack number>— J 

*1 I 1 

L OFFSET — <hexadecimal offset^ 



Explanation 

The following text describes the meaning of each construct: 
HEAPSTACK 



Displays the hexadecimal stack number of the process stack currently targeted for all 
HEAP commands, and the hexadecimal offset used to locate the heap descriptor. 

HEAPSTACK < hexadecimal stack number > 

Specifies the process stack to be used as the target for all HEAP commands. The 
hexadecimal offset is reset to its default value of 2. 



HEAPSTACK OFFSET <hexadecimal offset> 

Specifies the offset of the heap descriptor relative to the MSCW at lex level 2. 
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HEAPSTACK < hexadecimal stack number> OFFSET < hexadecimal offset> 

Specifies the process stack and offset to be used for subsequent HEAP commands. 

The HEAPSTACK command displays an error message if the specified process stack is 
of the wrong type or in the wrong state for use in a HEAP command. 

Examples 

The following example specifies stack IDE as the target and causes the default offset of 
2 to be used. The response indicates that DUMPANALYZER found a nonseparate heap 
at the default offset. 

INPUT: HEAPSTACK IDE 

HEAPSTACK = IDE, Compiled by level 37.335 Pascal, BOSR = 7B83B 
Separate Heaps are not in use 

Non Separate Heap row 0 in use (Default heap size), Top Of Heap is 6F 
System Page Size is 100 (256) words 



In the following examples, the user first specifies stack 1E0 as the target and causes the 
default offset of 2 to be used. The response indicates that there is no heap descriptor at 
that offset, and suggests that an offset of 2A be used instead. The user reenters the 
HEAPSTACK command, specifying an offset of 2A. The response indicates that there is 
a heap descriptor at that location. 

INPUT: HEAPSTACK 1E0 

HEAPSTACK = 1E0, Compiled by level 37.335 Pascal, BOSR = B9A80 
Non Separate Heap Seg Dope not present at (2,2) 
Failure loading heap information. 

Please specify the offset of the Non Separate Heap Array. 

Possible offset (s) : 

2A 

INPUT: HEAPSTACK OFFSET 2A 
Separate Heaps are not in use 

Non Separate Heap row 0 in use (Default heap size), Top Of Heap is 6F 
System Page Size is 100 (256) words 



Following is an example of a simple HEAPSTACK command. The response shows the 
stack number and offset that are currently in use. 

INPUT: HEAPSTACK 

Heapstack = 1E0, BOSR = B9A80 

Heapstack Offset = 2A 
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In the following example, the HEAPSTACK command specifies both the stack number 
and the offset. The response indicates that DUMPANALYZER found the heap 
descriptor at the specified offset. 

INPUT: HEAPSTACK 510 OFFSET 2A 

HEAPSTACK = 510, Compiled by level 39.80 Pascal, BOSR = 6E8B 
3 (3) Separate heaps in use 

Non Separate Heap row 0 in use(Default heap size), Top Of Heap is 6F 
System Page Size is 100 (256) words 



HELP 



The HELP command provides information about DUMPANALYZER commands. When 
DUMPANALYZER is run from the ODT, the response to HELP is displayed on the 
ODT. 

<hel p> 
— HELP 



— <dumpanalyzer command>— 
-<meta-i tem> 



The following text describes the meaning of each construct: 



HELP 

HELP <dumpanalyzer 
command > 

HELP <meta-item> 



A list of available DUMPANALYZER commands is given. 

A railroad syntax diagram and a brief explanation of the 
commands is given. 

A further explanation of most metalinguistic items (for example, 
<number>) is provided. The broken brackets are required for 
meta-items. 



10 



The 10 command invokes input/output (I/O) analysis of all peripherals. 



<io> 
— 10 



r 



3TT 



r 



i—/l\-<unit spec> 

L-/l\- UINFO | — |- 



SUMMARY 



RESULTQ 



h- NAMtS -j 
L ALL 1 



<active spec> 

<unit speo 

UNIT — i r— <decimal number>- 



INTERNAL - 
LOGICAL — I 
— <unit type>— 

- CATALOG 

OFFLINEUNIT 

VOLUNIT 

' — TAPEUNIT — 



4-60 



8600 0478-100 



DUMPANALYZER 



octive speo 
— ACTIVE 



r 



UNIT 



P INTERNAL "— T 
L LOGICAL — 1 



-<decimal number>— ' 



<unit type> 



MT 
PK 
DK 
CD 
HC 
DC 
DP 
NP 
VC 
SC 
LP 
CP 
CR - 
IP - 
HY - 
SP -I 



<AX optiorts> 



— ? — AX 



1 



WHERE 
STOP - 
SKIP - 



The following text describes the meaning of each construct: 



10 



10 ACTIVE 



Each I/O peripheral is analyzed and result queues are 
displayed. 

On EMS systems, the 10 ACTIVE form searches for active 
lOCBs; this search can be asynchronously monitored and 
controlled by entering the AX (Accept) message command 
after the 10 ACTIVE form has been initiated. 

The WHERE option displays the location of the search, the 
number of the physical unit now being searched, and the 
number of active lOCBs found so far. 

The STOP option cancels the search and prompts the user 
with the ": READY" message; no information from the search 
is saved. 

The SKIP option stops the search of the current unit and 
skips to the next unit (if any). The search occurs from the 
high end of memory toward 0; thus, memory indices printed 
in response to ?AX WHERE decrease. 

The 10 ACTIVE form of the command is equivalent to the 
simple 10 form of the command, and has no effect when 
analyzing a dump created by an HDU system. 
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10 UNIT <decimal number> 



10 UNIT <unit type> 

10 UNIT CATALOG 
10 UNIT OFFLINEUNIT 
IOUNITVOLUNIT 
10 UNITTAPEUNIT 



IOUNITVSUNIT 

10 UINFO 

10 UINFO NAMES 

10 UINFO ALL 



10 RESULTQ 



10 SUMMARY 



The 10 UNIT <decimal number> form of the command 
causes the analysis of the designated I/O peripheral. Each 
I/O peripheral has a unique physical unit number associated 
with it. It is that number that is used as the decimal number 
in this form of the command. 

The 10 UNIT form of the command can also indicate 
whether the unit number used is an internal unit number or 
a logical unit number. If neither INTERNAL nor LOGICAL is 
used, the <decimal number> is assumed to be an external 
unit number. An example of this form of the command is IO 
UNIT INTERNAL 27 . 

This form of the command causes the analysis of all 
peripherals of the designated I/O peripheral unit type. 



These forms of the command provide specific table 
information concerning catalog units. To give significant 
information, these forms of the command must be followed 
by a UINFO option. 

This form of the command provides specific table 
information concerning the dummy unit used for the 
InfoGuard Volume Directory. 



If the UINFO option is specified by itself, a unit information 
analysis is provided. A basic analysis of each I/O peripheral, 
identical to that provided by the 10 form of the 10 
command, is given; in addition, a UINFO entry for each 
peripheral is given. The UINFO option lists the contents of 
each UINFO entry as an uninterpreted array. When the 
UINFO NAMES option is used, it provides a columnar listing 
of the entries and the purpose of each word. The 
mass-storage lists and other arrays attached to the UINFO 
entry are not printed. These lists can be obtained by using 
the UINFO ALL option. The UINFO ALL option applies only 
to pack and disk. 

The 10 RESULTQ form of the command provides the user 
with result queues that are otherwise suppressed. This 
option is only valid on EMS systems. An example of this 
option is "10 UNIT MT RESULTQ". 

The 10 SUMMARY form of the command provides a skeleton 
analysis of each specified I/O peripheral unit. The unit table 
and I/O queue expansion are suppressed from the output. 
An example of the use of this option is 10 UNIT MT 
RESULTQ SUMMARY. 
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Examples 

Figures 4^11 and 4-12 show example output from the 10 command. 
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INPUT: 10 UNIT 113 

(UNIT 9 000FA1C8. UNITMAP 9 000F8FE6. 61 VETAKERCW 9 000FA26C, 

UNITC0NTR0L 9 000FA4A9. UINFO 9 000FA176, UNITIOERR 9 O0O1FF49. 

PATHCNTRL 9 000FA003. COMMANDOUEUES 9 000FC062, HOR I ZONTALQUEUES 9 QOOFBFFD, 

RESULTQUEUES 9 0001FFEF, UNITSTATUS 9 0001FEA5, UNITMISC 9 0001FEF7) 



********** HT113 LOGICAL, 
0 3C8000 019000 UNIT[038] 



UNIT 56 ********** 
MT113_£9-IRK_/ PE / 1600 BPI) 



LABEL READ. 
[LLED *l 

TYPE=4(MTGCRV) 



LABELLED *$YSTEM/FILEOOO REEL 1 
[038] 

. suen 



OOOOOO 800000 UNITI0ERR[ 

lEOOOO 029047 UNI TC0NTR0L[038 J 

FIPS COMPATIBLE GCR MAG TAPE. REL UNIT=00. DYNAMIC UNIT, 
, HAS STATUS, STATUS RUNNING, 0ATH NODE IND£x=00047 
090000 071012 UNITMAP[038] 

, UM, NUMBER OCCUPIED, UML0GF=56, UMPHYSF=113 
04E871 D8536C GI VETAKERCW[038 J 
r UNIT 

1:00001 F20002 UNITSTATUS[038J 

UNIT EXISTS, PHYSICALLY READY, LOGICALLY READY . 
AN I0P SEES THIS UNIT AS READY. 
PATHS SEEING UNIT READY: 1. 



GIVEN 9 136C:071D:4 (51641600) READALABEL BY STACK 04E 



>>»> UNIT QUEUE 9 000FB02F 

UQ CONTROL WORD: 0 10CC00 000154 



HEAD IOCB LINK: 
TAIL I0C8 LINK: 
HQ HEAD PTR: 
DU QUEUE LINK: 
LAST IOCB : 
SPARE IOCB OESC: 
I/O OPT WORD #1: 
I/O OPT WORD #2: 
PATH WORD: 
UNIT PATH INFO: 
SOFTWARE WORD: 



DLP INDEX #1: 
DLP INDEX #2: 
OLP INOEX #3 
DLP INDEX #4 
DLP INDEX #5: 
DLP INOEX #6: 
DLP INDEX #7; 
DLP INDEX #8: 
CHECK HUNG I/O: 



OOOOOO 
OOOOOO 
EOOOOO 
OOOOOO 
C00001 
OOOOOO 
OOOOOO 
OOOOOO 
C00002 
OOOOOO 
010086 



800001 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



OOOOOO 
OOOOOO 
1021F1 
OOOOOO 
E02282 
OOOOOO 
OOOOOO 
OOOOOO 
A021F2 
000002 
000008 



E02282 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



INACTIVE COUNT=00, ACTIVE COUNT=00, ACTIVE LIMIT=01, 
DYNAMIC PATH SEL., SUSPENOED, HORIZ\ Q PRESENT 



READY PHYSICAL PATH TO OLP INOEXES: 1. 
STATUS MONITORING: INITIATED BY DOSTATUSIO 
MISC. INFORMATION: LAST SUSPENDED BY DOSTATUSIO 
SUSPENDED BY: DOSTATUSIO 



***** PATH GROUP TA8LE FOR UNIT QUEUE 9 000FB02F ******> 
PGT LOCK : 0 10C300 OOOOOO 

PGT STATE : 0 028000 010021 DYN PATH SEL DLPS: 1, PGT VERSIONS, CONNECT 
IOP INF01 : 0 OOOOOO 002200 DLPAW INDEX=22 

IOP INF02 : 0 OOOOOO 001A02 DLPAW INDEX=1A, DLP MASK CONTAINS DLP INDEXES:1. 
DLP INF01 : 0 OOOOOO 000400 DLP ACTIVE COUNT=00 
UNIT qUEUE IS EMPTY ) 



INPUT: 10 UNIT LOGICAL 51 UINFO NAMES 



PHYSICALUNITINFO 

PHYSICALUNITINF03 

PHYSICALUNITINF06 

PHYSICALUNITINF09 

HAQDOPEVECTOR 

ACT I VEHCBHEAD 



006700 
00007F 
003500 
003300 
002800 
00007F 
000000 
000000 
000000 
800000 



ASD INDEX 
ASD INDEX 
ASD INDEX 
ASD INDEX 
ASD INDEX 
ASD INDEX 



03178; PHYSICALUNITINF01 
0317B; PHYSICALUNITINF04 
0317E; PHYSICALUNITINF07 
LOGICALUN I T INFO 
RQDOPEVECTOR 



M ffli 



03 



ASO INDEX 
ASD INDEX 
ASD INDEX 
ASD INDEX 
ASD INDEX 



03179 
0317C 
0317F 
03186 
03177 



040AC; PHYSICALUNITLOCKWOROS ASD INDEX = 03i76) 



PHYSICALUNITINF02 ASO INOEX 

PHYSICALUNITINF05 ASO INOEX 

PHYSICALUNITINF08 ASD INDEX 

PHYSICALUNITQUEUES ASO INOEX 

ECODOPEVECTOR ASO INOEX 



0317A; 

0317D; 

03180 

03182; 

03187 



********** |_p 5 
0 100080 01C000 

UINFO 

0 000000 000000 
0 001300 000007 
0 427010 A08000 



UNIT 



[033] 
UNIT 



NAL UNIT 4 LOGICAL UNIT 51 
033] LP5 (TRAIN PRINTER) TRAINID 
SCRATCH, AUTOBACKUP 

o oogooo oooooo 



********** 



16, TRAIN NAME=EBCDIC96, LPK IND=TRANSLATE TABLE, M0DE=8-BIT 



PHYSICALUf) 
PHYSI 



0ERRr033l 

CALUNITINF0[00041, 
CALUNITINF0I[0004] 



650004 
FF0065 
005000 
000006 
040006 
FF0003 
000005 
OOOOOO 
OOOOOO 
403250 



PHY S 1 CALUN I T I NF02 
PHYSICALUNITINF03 
PHYS1CALUNITINF04 
PHYSICALUNITINF05 
PHYSICALUNITINF05 
PHYSICALUNITINF06 
PHYSICALUNITINF07 
PHYSICALUNITINF08. _ , 
PHYSICALUNITLOCKWOBDSfO 
PHYSICALUN ITQUEUESL0004 



0004 
0004 
0004 
0004 
0033 
0004 
0004 
000 



CURRENT HDU = 0, DLP-RELATIVE NUMBER = 0, TRAIN PRINTER. 

QUEUE COUNT = 1. IN PARTITION. CURRENT STATUS, CHECK STATUS, 
TEST WAIT OP, ON LINE, MONITORING STATUS, READY HAS STATUS. INHIBIT TEST WAIT COUNT * 0, 
RING WALK COUNT =0, 
UNIT PORT = 103, UNIT DLP = 101, 



PHYSICAL STOP C6UNT « 0, LAST UNIT ON EXCHANGE, FIRST DLP SERVING 
CTP STATUS = 0, NORMAL tlMEOUT INTERVAL (80), 
MAJOR TYPE IS UNIT, 

LAST DEVICE IN CLASS 4, NEXT DEVICE BY TYPE = 3, 



101, 



104] 

I 5 COOOOO 803244 



0 OOOOOO OOOOOO 0 OOOOOO OOOOOO 0 OOOOOO OOOOOO 



5 COOOOO 803244 COMMAND QUEUE 
0 10CC00 000104 
0 OOOOOO OOOOOO 
0 OOOOOO OOOOOO 
5 COOOOO 8031A3 
0 OOOOOO OOOOOO 



0: QUEUE IS RUNNING, STOP COUNT = 0. IOS OUTSTANDING = 0, SOFT QUEUE LENGTH = 0, 
CO CONTROL WORD: ACTIVE COUNT = 0, ACTIVE LIMIT = 1, DLP PRESENT, 

HEAD IOCB LINK 

TAIL IOCB LINK 

DLP QUEUE HEAD POINTER 



IOCB'S IN RQ FOR CQ 0: 



* HCB ANALYSIS 
CONTROL WORD: 

DLP COMMAND: 
HDU RESULT: 
DLP RESULT: 
C-Q POINTER: 
R-Q POINTER: 
MISCELLANEOUS: 



RAW HCB: 



(HCB ASD INDEX = 4'032E6'] 1 (HCB 

">T PROCESSOR ON FINISH, 



, 9 4'00120728') 

10CB00 00C409 OLP COMMAND, INTERRUPT PROCESSOR ON FINISH. TESTOP. CHARACTER MODE, 

FORCE TAGS to SINGLE, QUEUE AT HEAO, IGNORE. COUNT ERROR, CQ IMMEDIATE 
2200 

OOOOOO OOOOOO 
0041 

COOOOO 803244 
COOOOO 8031A7 



TEST WAIT EPILOG. PHYSICAL UNIT NUMBER = 4'0004' ACTIVE, RETRY COUNT = 0, 



0 OOOOOO 003030 



L0GICALUNITINF0[033] 

NOT HELD (RESERVATION 



SUCCESSOR = 5 COdOOl 8032ED, MASK 
PATH = 006700 650004 
0 10CB00 00C409 0 OOOOOO OOOOOO 5 
5 COOOOO 8031A3 0 000002 OOOOOC 5 
5 COOOOO 8031A7 0 030000 12073B 0 
0 OOOOOO OOOOOO 0 OOOOOO OOOOOO 0 
0 OOOOOO OOOOOO 0 004100 OOOOOO 0 



844110 lOOOOfi, I/O TlME > 1 SECOND, 



COOOOO 803244 
E40001 3032E6 
OOOOOO OOOOOO 
900000 004800 
OOOOOO OOOOOO 



C00001 8032E6 
E40001 5032E6 
040002 0032E6 
C00001 8032E5 
006700 650004 



C00001 8032ED 
844110 100000 
000013 D2DAD3 
220000 OOOOOO 



3, NOW SERVING = 3) 



******** 



OLP1003 
7FFF10 004133 



********** 



INTERNAL DEVICE 101 

PHYSICALUNITINFO [0065 J DLP WEIGHT = 1, IN PARTITION, B9246-20 2000 LPM TRAIN PRINTER, 



0 000400 637FFF 
0 006600 200003 



PHYSICALUNITINFOU 
PHYSICALUNITI NF02[0065 



SLOT IN BASE = 3 X 

0065] FIRST UNIT SERVED = 4. CONTAINING BASE = 99, LAST OLP ON EXCHANGE, 

] NEXT DLP IN BASE = lOi, DLP ADDRESS = HOU 0 9 HDP 0 9 MLI 0 9 LEM PORT 0 9 DLP 3 HRF = 2, 
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IOCB 



The IOCB command prints the I/O control block (IOCB) specified by < simple address > 
or <ASD number>. If the specified area is not an IOCB, then DUMPANALYZER 
displays an error message. 



<iocb> 
— IOCB 



VIA - 



-<simple address>- 
-<ASD number> 



The following text describes the meaning of each construct: 
IOCB <simple address> 



IOCB AT <simple address> 



IOCB VIA <ASD number> 



The IOCB command analyzes both lOCBs and hardware 
control blocks (HCBs) for HDU systems, and only lOCBs for 
EMS systems. The word located at the <simple address> is 
a descriptor that can refer to either an IOCB or an HCB. If 
the descriptor refers to an IOCB and an HCB has been 
allocated for that IOCB then both structures are analyzed. 
Word three of the structure pointed to by the descriptor is 
checked to determine if the the descriptor is for an HCB or 
an IOCB. If the tag of the word is 5 (indicating that it is a 
data descriptor), then the word is assumed to be the HCB 
Self Pointer and the descriptor is assumed to point to an 
HCB; otherwise, the descriptor is assumed to point to an 
IOCB. 

The IOCB located at <ASD number> is analyzed and 
printed. 



Examples 

Figure 4-13 shows example output from the IOCB command. 
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* SOFTWARE 
HCB CW: 

IOCW: 

LOGICAL RD: 
LAST RESULT 
OLP COMMAND 
HOU RESULT: 
DLP RESULT: 
AREA OESC: 



MISCELLANEOUS 



RAW IOCB: 



RAW HCB: 



4 , 0377E'). (IOCB g 4'0002C9F8') 
CHARACTER MODE, * 



FORCE TAGS TO SINGLE , 



IOCB ANALYSIS * (IOCB ASD INDEX 

0 10CBOO 046420 OLP COMMAND, READ, 

CONTINUE COUNT, IGNORE COUNT ERROft 
0 1303CO 000000 READ. 8-BIT, MEMORY PROTECT 
0 000000 000101 0 CHARACTERS TRANSFERRED, EOT, EXCEPTION 
: END OF TAPE 
8220 
0 000000 000000 
0001 0280 

5 E40000 10118A {ASD INDEX = 4'0118A'), BASE ADDRESS * 4'0002CA43', WORD INDEX = 

BYTE INDEX = 0 
IN PROCESS, ACTIVE. REQUEST LENGTH * 234 
REQUESTOR = 10, OWNER * " 



BUFFER' DESCRIPtOR%' 5 



ERROR MASK « 4*08001 ', 



VENT REFERENCE = 5 E100Q5 503779, LOGICAL UNIT NUMBER - 4 T 0030 T . 
HYSICAL UNIT NUMBER » 4 T 0007 Y RELATIVE CO = 0, LAST PATH = 006700 690007 
ORT = 4'67' DLP = 4'69'. TIME CELL = 0, RETRY COUNT = 0. LOGGED RDS COUN 



EVENT 
P 

POR. , «, , u 
0 10CB00 046420 
000000 000000 
000000 000005 
E10005 503779 
822000 000000 
000000 000000 
10CB00 046420 
COOOOO 8031A5 
COOOOO 8031A7 
000000 000000 
000000 000000 



CHARACTERS, .... 
STACK * 4'012'. INITIATING STACK » 4'054' 
C4000F 00118A, FIB DESCRIPTOR > 0 OOOOOQ dOOOOO, 
" " M UNIT NUMBER » 4 Y 0030\ 



000000 dooooo 
000002 OOOOOC 
E40000 10118A 
000000 000000 
000000 000000 
000000 300000 
000000 000000 
000002 OOOOOC 
E40000 10118A 
C00001 B0377E 
000000 000000 



1303CO 000000 
E40001 40377E 
000000 OOOOEA 
006700 690007 
000102 800000 

COOOOO 803247 
E40001 40377E 
000000 OOOOEA 
900000 007000 
000000 000000 



000000 000101 
E40001 60377E 
C4000F 00U8A 
012054 
000000 



C00001 
E40001 



288001 
000000 

8032C7 
60377E 



040002 800020 
COOOO! 8Q32BD 



J0007 



.... COUNT * 0 
200000 000101 
000100 010000 
000000 000000 
003000 000006 
C00001 8032C7 

000000 000000 
000100 010000 
000000 001BA3 
2A0000 000000 
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IOTABLE 

The IOTABLE command gives I/O information pertaining to the specified IOP This 
information includes expansion of the IOCB queue pointed to by the I/O table. This 
command is valid only for dumps executed on Micro A, A 1, A 2, A 3, A 4, A 5, A 6, and 
A 10 systems. 

<iotable> 

— IOTABLE — < IOP number > — | 

The following text describes the meaning of the variable: 
<IOP number> An integer between 0 and 7. 

Example 

Figure 4-13 shows example output from the IOTABLE command. 
IOTABLE 2 

##### I/O TABLE FOR I0P# 2 0 00020347 ##### 
I/O TABLE CW :0 10C000 000000 
IOCB QUE HEAD PTR:5 C00000 3202F8 

( IOCB QUEUE ) 

IOCB QUE CW :0 10C100 000000 
IOCB QUE HEAD:0 000000 000000 
IOCB QUE TAIL:0 000000 000000 



IOP QUE CW 
IOP QUE HEAD 
IOP QUE TAIL 
EMP DEST. SET 
IOP DEST. SET 
SCRATCH AREA 



0 10C200 000000 

0 000000 000000 

0 000000 000000 

0 000000 000400 EMP#10. 

0 000000 000006 IOP #1, I0P#2, 

5 E00001 C1D551 



KEEP 



The KEEP command causes the last command entered to be saved for future use. This 
command is stored in a 10-deep, first-in-first-out queue. Each entry has a number 
between 0 and 9, inclusive, which is used if the entry is recalled by the USE command. 
(Refer to the USE command.) 

<keep> 

L<number>-J 



The following text describes the meaning of each construct: 



KEEP 



The last command entered is saved at the next available number 
between 0 and 9. The command is retrieved by the USE 
command. 



continued 
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continued 



KEEP <number> 



Assigns a command to be stored at the specified number 
between 0 and 9. 



For more information, see the discussion of the USE command in this section. 
Example 

The following is an example of the response to a KEEP command: 

INPUT: KEEP 
SAVED: #2 



LIB 



The LIB command analyzes and prints library information. 



<lib> 



— LIB 



- AT — <simple address^ 

- VIA — <ASD number> 

- MAP -| — 




The following text describes the meaning of each construct: 



LIB AT <simple 
address> 



LIB VIA <ASD number> Analyzes the contents of the indicated location of memory as a 

library structure. 



LIB MAP Displays the contents of the library map. Empty slots in the map 

are not displayed. 



LIB MAP <number> Displays the contents of a linked list chain in the library map, 

starting at the given index. 



LIB SL 



Displays the system library function definitions. 
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Examples 

The following is an example of the response to the LIB AT <simple address> 
command: 

INPUT: LIB AT 45A8 

HEADER 

LEVEL = 3, LOCKED. 

STACK INFORMATION: IMP AT 001D IN STK 090 = (*,0009). 

USEINFO 

LINKED TO STACKS: EXP AT 0019 IN STK 0A1. 



AREAS 




FREE 


0031 


USEINFO 


002D 


STACKREF 


0006 


IMPORTS 


000B 


EXPORTS 


0000 


TYPES 


000E 


NAMES 


0012 


ATTRIBS 


001A 


• IMPORT 


OBJECTS 



([V] = BY VALUE, [R] = BY REFERENCE, [N] = BY NAME) 
ALSOLINKED IS A INTEGER FUNCTION (1 PARAMETER); 
INTEGERIV] ; 

INDEX = 12, OBJECT = (*,000B). 

ATTRIBUTES 

VALUE = -5 H 400 0000 00005, INTNAME = L, 
TITLE = LIBRARY/MULTIPLELINKERROR. 



The following is an example of the response to the LIB MAP command: 
INPUT: LIB MAP 6 



MAP [6] 


= STK 045, 


HDR 0017, 


NEXT = 


5 


MAP [5] 


= STK 044, 


HDR 0019, 


NEXT = 


4 


MAP [4] 


= STK 03F, 


HDR 001B, 


NEXT = 


3 


MAP [3] 


= STK 03E, 


HDR 001D, 


NEXT = 


2 


MAP [2] 


= STK 03A, 


HDR 0020, 


NEXT = 


1 


MAprn 

u-j 


= STK 036 s 


HDR 0024 
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The following is an example of the response to the LIB SL command: 
INPUT: LIB SL 

SL BNASUPPORT = *36/SYSTEM/BNASUPP0RT 

ONLY 1, LINKCLASS 1 
SL COMSSUPPORT = *SYSTEM/COMS 

LINKCLASS 1, TRUSTED, HDR 0057 
SL DATACOMSUPPORT = *36/SYSTEM/DATAC0MSUPP0RT 

ONLY 1, LINKCLASS 1, HDR 005A 
SL GENERALSUPPORT = *36/SYSTEM/GENERALSUPP0RT 

HDR 0055 

SL MCPSUPPORT ' = "» CURRENT MCP «" 
MCPLIB, STK 010, HDR FFFF 



LINKCHECK 



The LINKCHECK command examines each memory link in the in-use and 
available areas of memory. If an error is found, an error message is displayed and 
DUMPANALYZER recovers and continues. Note that LINKCHECK is valid only 
for complete memory dumps. Because the memory links are validated before the 
dumping process is initiated and the memory is not in any special order, LINKCHECK 
is disallowed for ALLINUSE and PARTIAL memory dumps. 

<1 inkcheck> 

— LINKC HECK 1 

<AX options> 

— ? — AX — r— WHERE 

- STOP - 

- +T — 
I T — 

The following text describes the meaning of each option: 
?AX WHERE Asks where the LINKCHECK is. 

?AX STOP Stops the LINKCHECK and reprompts the user with a ": READY" 

message. 

?AX -T By default, LINKCHECK prints the contents of areas where link 

corruption occurred. ?AX-T suppresses this printing. 

?AX +T Reenables the printing of areas where link corruption occurred. 

Example 

The following is an example of LINKCHECK output indicating that link corruption 
was found: 

LINKCHECK 

TAG ERR & 27621-27620 : 0 000000000000 



8600 0478-100 



4-71 



DUMPANALYZER 



The LINKS command prints the addresses and contents of each link of the memory 
area that contains a specified < simple address >. The analysis also includes the 
following memory area attributes, which are encoded in the links: 

• Whether the area is available, save, csave (currently saved), or olay (overlayable) 

• If in-use, whether it is code, data or read-only 

• The area size 

• The area MOM address 

• Whether or not the MOM address for the area is in the MCP D[0] stack and, if the 
name of that cell is available, the D[0] MOM address name 

• The area stack number 

• If present, the link C RCW 

• The memory priority of the area 

• If the area is available, the RCW trace of FORGETSPACE 
<links> 

— LINKS — [— <simple address> 1 — . 1 1 

L VIA — <ASD number^- 1 L EXPAND - 1 

The EXPAND option expands the fields of the associated ASD. 
Examples 

An example of the LINKS command output for an in-use area is given in Figure 4-14. 

An example of the LINKS command output for an available area is given in 

Figure 4-15. Note that the RCW trace information appears only for dumps created on 

a system running a DIAGNOSTICS MCP 
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INPUT: LINKS 4000 EXPANO 

00003019 INUSE AREA DATA: LENGTH=04209( 1690S)M0M AOOR*000028AO (0[0] + 07A0) 
ASDl[010D5l: [00041009] 5 670000 00301C 

A501 PRtSENTTOPROCF «= 1 

ASD1 - UNALTEREDF » 0 

ASDl-NOTSTACKF * l 

ASD1~PRESENTF0R IOF « 1 

ASOl-NOTPAGEF « 1 

ASD1-READ0NLYF =0 

ASDl'DONTRESIZEF = 0 

ASD1-PAGEDF « 0 

ASDl-ADDRESSF * 0000301C 

ASD2[010D5l: [O006AO34] 3 160000 004209 

ASD2 SPACEUSAGEF = 16 (PERMSAVEAREA) 

AS02^LENGTHF « 04209 

AS03[01O05l: [00092F8F] 1 012000 8407A0 
STACK NUMBER * 012 

DISPLACEMENT - 0008 

OFFSET = 07A0 

ASD4[010D5l: [0008BEEA] 0 000000 001200 

A5D4 LI NKASOINDEXF = OOQOO 

ASD4-0LAYSTATEF = 0 INON OVERLAYABLE SEG) 

ASD4-0WNERSTACKF =012 

AS04-VIRGINASDF = 0 
AS04-MARKEDF0RWSSHERIFFF = 0 

ASD4~UNLOCK01 SPOSALF =0 

AS04-L0CKBITF = 0 

LINK A : £00003019] 6 E04200 001005 
Orot MOM AODRESS NAME 8 RESCOOE MEMORY 
SPACE USAGE = (PERMSAVEAREA) 

INUSE SEGSTATEF * SAVE AREA 

INUSE-ASOINDEXF = 01005 

INUSE'SIZEF * 004200 

LINK C : [00003D1B] 3 000000 000000 

LINK Z : |"00007F25] 3 E0420D 000000 
INUSE SIZEF « 004200 
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INPUT: LINKS 7E42DE 

007E42D9 AVAILABLE AREA : LENGTH * 00000016(22) 
LINKS: 1 480000 000016 0 000000 D67275 0 OOOOi 

RCW TRACE OF FORGETSPACE 

STACK: 894 

| 1005:037F:0 (04899700) FORGETSPACE 
9 100F:OOA9:4 (04700750) AMNESIA 
9 U06:0ACB:1 20881800) MUTATE 
9 0248:003E:1 
g 0247:0198:1 , 

9 1207:0103:4 24565550) BLOCKEXIT 
9 0247:0160:4 

9 10EA:06DB:1 (16562000 BOJEOJ 



00 000000 0 000000 000000 0 000000 000000 



1 400000 000016 
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LOADXREF 

The LOADXREF command associates a set of cross-reference information files with a 
segment dictionary stack or with the MCP The cross-reference information files are 
used to display identifier name and compiler class along with stack variables. The 
LOADXREF command depends on the presence of an XREFSUPPORT system library. 
XREFSUPPORT must have been established as a support library with the SL (Support 
Library) system command. 

If the code file was compiled without the LINEINFO option set, the identifier 
information cannot be displayed. 

If LOADXREF has been requested for a stack and the IDNAMES option has been 
requested in the MODE command, the BINDINFO information is used to identify 
stack variables instead of the cross-reference information files. 

If BINDINFO information does not exist for an environment, then the cross-reference 
information files are used. The LOADXREF command cannot be used to get identifier 
names for environments that are bound into the MCP 

<1 oadxref > 

— LOADXREF -r- MCP r- " — <code file name>— 11 -, , 1 

I— <number>— ' •— : — C — ' 

The following text describes the meaning of each construct: 

LOADXREF MCP The cross-reference information files, XREFFILES/<code file 

"<code file name>" name>/DECS, XREFFILES/<code file name>/REFS, and 

XREFFILES/<code file name>/LOCS are associated with the 
MCP code file and then used to display identifier name and 
compiler class along with stack variables. 

LOADXREF <number> The cross-reference information files, XREFFILES/<code file 

"<code file name>" name>/DECS, XREFFILES/<code file name>/REFS, and 

XREFFILES/<code file name>/LOCS are associated with the 
specified stack if it is a segment dictionary stack, or with the 
segment dictionary stack for the specified stack. Cross-reference 
information files for a stack whose segment dictionary stack is 
the MCP stack can be loaded only by using the 
LOADXREF MCP form of the command. 

: C The XREFFILES/<code file name>/LOCS file is needed by the 

LOADXREF command to process cross-reference information files 
more efficiently. Use this option to request the creation of a 
LOCSfile in the user's directory if a valid LOCS file is not found. 

A LOCSfile can also be created by running the 
INTERACTIVEXREF utility with the SW1 task attribute set to 
true. For further information about INTERACTIVEXREF, refer to 
the A Series System Software Utilities Operations 
Reference Manual 

For more information, see the discussion of the MODE command in this section. 
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{ 

LOCKS 

Locks or events are denned as being in one of two states: normal or abnormal. An 
abnormal event is one that is procured or has a stack waiting on it. All EVENTs and 
EVENT ARRAYs declared in the MCP outer block are considered, but only abnormal 
ones are listed. Hard locks are not reported. 

<locks> 

— LOCKS 1 

Note: The MCP global events and event arrays are located using 

BINDINFO data in the MCP code file. If the analyzed code file does 
not match the dumping MCP code file, the event analysis might be 
incorrect. 

Example 

Figure 4-16 shows example output for the LOCKS command. 
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IBLE. HAPPENED. PROCURED 
400380 2 ooodoo 000000 



INPUT: LOCKS 

MCP EVENTS (PROCURED OR WITH WAITERS) 

6 AB8 2 000660 000008 2 000A03 001A1B 

(UNAVAILABLE. PROCURED BY STK 066 
G 4F8 2 0002F0 0O06O9 2 000806 1012F3 

(UNAVAILABLE. HAPPENED. PROCUREO 
6 56A 2 000370 000009 2 000400 801AAB 

(UNAVAILABLE. HAPPENEO. PROCURED 

2 0004B0 0O06O9 2 000A09 401331 

(UNAVAILAr ~ 
G 9AB 2 000000 < 

(WAITING: STK 038) 

2 000000 300380 2 000000 000000 

(WAITING: STK 038) 
G 4C3 2 0002F0 000008 2 000206 4012F3 

(UNAVAILABLE. PROCURED 8Y STK 02F 
G BB7 2 000000 1004C0 " 

(WAITING: STK 04C 
G EES 2 000000 100680 

(WAITING: STK 068 
G 6AB 2 000310 000008 

(UNAVAILABLE. P 
G 1AA 2 000000 100*60 

(WAITING: STK 076 
G 32D 2 000000 000330 

(WAITING: STK 033 
G 9AB 2 000000 400380 

(WAITING: STK 038 

2 000000 300380 

(WAITING: STK 038 



18 UPDATE FLOG LOCK 

066 9 1A18T003DT5 (85899872 UPDATE FLOG ) 

F3 DCINITI ALLOCK , " . 

ED BY STK 02F 9. 12F3;0061 :4 (49253274) BUM 



Y STK 02F f r 12F3;0061:4 (49253274) BUILD DC TABLES ) 

HEADERLQCKS[0006J . , . " " 

BY STK 037 9 r 1AAB-0008 : 2 (94560600) ) 

HEADERL0CKS[005D) 

BY STK 04B 9 1331:0094:5 (37991900) RELEASEHEAOER ) 
PSE10005J 

PSE[0006] 
DCPREFIXLOCK , 

9 12F3:0064:1 49253280 BUILO DC TABLES 
SLOGMONITOREVENT ~ ~ 



000000 000000 



000000 000000 AHW ATTENTION 



00005C E011CF 
PROCURED BY STK 031 
000000 000000 



000000 000000 
000000 000000 
000000 000000 



CTRLWARELOCK 

9 UCF:05CE:0 (32195290) PATHRES ) 
OLAYSPACEWANTED 

ANABOLEVENT 

LISTS_E[0005] 

LISTS E[0006] 



8600 0478-100 



Figure 4-16. LOCKS Command Output 
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MASK 

The MASK command is used to set or examine the mask register. The MASK command 
is used in conjunction with the PATTERN and SEARCH commands to search a dump 
for all words that contain a particular pattern of bits. The mask register modifies the 
pattern in the pattern register by masking certain bits in the pattern. The SEARCH 
command searches for all words which match that part of the pattern which is not 
masked. (Refer to the PATTERN and SEARCH commands for further information.) 

<mask> 



— MASK 





-<simple value>— 


1 




- ABSENTDESC 






- ABSENTCOPY 






L MOMDESC 1 





The following text describes the meaning of each construct: 

MASK MASK specified by itself displays the contents of the mask 

register. The default for the MASK register is 7 FFFFFF FFFFFF. 

MASK <simple value> Places a mask that can be expressed as a given <simple value> 

into the mask register. A mask is a distribution of Is and Os in a 
48-bit word and its 4-bit tag. The mask indicates which bits are 
significant and which are irrelevant within the current pattern set 
by the PATTERN command. All bits in a mask that have a value 
of 1 are significant digits in the pattern. All bits in a mask that 
have a value of 0 are disregarded in the pattern. The mask most 
recently specified is stored in the mask register. 

The mask Can include the 4-bit tag for a word. To specify a TAG, 
the concatenation form of simple value should be used; input 
would specify 12 hexadecimal digits & <number> TAG. The 
tag value should be no larger than 15; however, if it is larger 
than 15, the tag value is placed in the tag using modulus 16. If 
no tag is specified, the tag is assumed to be 0. 

Although the mask represents 48 binary bits and a tag value of 
4 binary bits, it is displayed and is most often set in 
hexadecimal. Refer to Figure 4-17 for a diagram of a word that 
contains a mask value, with its hexadecimal equivalent stated 
below it. 
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bit# 



47 


0 


0 


0 


0 


0 


0 


0 


0 


1 


1 


1 




46 


0 


0 


0 


0 


0 


0 


0 


0 


1 


1 


1 




45 


0 


0 


0 


0 


0 


0 


0 


1 


1 


1 


1 




44 


0 


0 


0 


0 


0 


0 


0 


1 


1 


1 


1 





0 0 0 0 0 0 0 



Figure 4-17. Mask Word Example 

To indicate that the last 18 bits of the pattern word and its tag 
are significant, the corresponding mask command would be 
MASK 3FFFF & F TAG. (It is understood that there are seven 
leading zeros.) The mask register would display its contents as F 
000000 03FFFF. 

The default for the MASK register is F FFFFFF FFFFFF; in this 
case, all bits including the four tag bits (represented by the 
leading F) are set to one, and therefore are significant in the 
pattern register. 

MASK ABSENTCOPY A mask value appropriate for finding descriptors is placed in the 

MASK ABSENTDESC mask register. The same mask value is generated, regardless of 

MASK MOM D ESC whether the ABSENTCOPY, ABSENTDESC, or MOMDESC option 

is specified. If the dump was created on a system running 
E-mode level Beta, the mask value is F C00000 000000. If the 
dump was created on a system running E-mode level Gamma, 
the mask value is C 000000 000000. As of this publication, 
only A 16 systems run E-mode level Gamma. The Micro A, A 1, 
A 2, A 3, A 4, A 5, A 6, A 9, A 10, A 12, A 15, and A 17 run 
E-mode level Beta. 



Examples 

INPUT: MASK 

MASK: F FFFFFF FFFFFFF 

INPUT: MASK ABSENTCOPY 
MASK: F C00000 000000 

INPUT: MASK MOMDESC 
MASK: F C00000 000000 

INPUT: MASK 123456789ABC 
MASK: 0 123456 789ABC 

INPUT: MASK 1324 & 5 TAG 
MASK: 5 000000 001324 
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( 

For more information, see the discussion of the PATTERN and SEARCH commands in 
this section. 



The MD (Memory Dump) command dumps the contents of a group of addresses in 
memory with no analysis. 

<md> 

— MD — <multiple addresses> 1 



Example 

A small subset of the raw dump analysis, which is output from the MD command 
follows: 

INPUT: MD C119D to C1200 



000C119D (00000000) 


0 


C00040 


190C6D 


7 


700120 


080C7F 


000C11A4 (00000007) 


0 


000000 


000000 


0 


300023 


000096 


000C11AB(0000000E) 


0 


400000 


00CF62 


0 


000000 


000074 


000C11B2 (00000015) 


0 


000000 


000000 


0 


000000 


000000 


000C11B9(0000001C) 


0 


000000 


000000 


THRU 000C11DB(0000003E) 


000C 11 DC (0000003 F) 


1 


4000A0 


000000 


6 


C0001C 


180C5A 


000C11E3 (00000046) 


3 


B20695 


B4AE42 


3 


4E601A 


AFB208 



The word THRU in the output identifies a sequence of repeated words. For example, in 
the block of zero operands, 000C11B9 and 000C11DB are the addresses of the first 
and last zero operands, in hex. The hex offsets in parentheses such as (0000001C) and 
(0000003E) represent offsets that are relative to the beginning address requested. 
Each word is broken into tag, upper half, and lower half. 



MDCODE (HDU Systems) 



Note The MDCODE command has been deimplemented. This command 
had meaning only on systems with ASN memory, which is not 
supported on the Mark 3.9 system software release and later releases. 



MEM 

The MEM (memory) command lists the memory modules present and the range of 
addresses contained in each module on the system when a dump was created. 

<mem> 

_ MEM 1 
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Example 

The following is an example of output from the MEM command: 
INPUT: MEM 



MEMORY MODULES IN DUMP (MODULE = 128K WORDS) 

0 (00000000) - 63 (007FFFFF) 
TOTAL MODS READY: 64 



MESSAGES 



The MESSAGES command finds, analyzes, and prints the DATA COMM messages in 
the system. This is useful for determining 

• If any stations or MCSs have loaded the system with messages 

• The amount of DATA COMM traffic to various stations. 

• If an MCS is recalling messages correctly 

Note that this command works only for COMPLETE or ALLINUSE memory dumps; it 
is rejected for PARTIAL memory dumps. 

Due to the nature of DUMPANALYZER and the way it accesses memory, a message 
analysis sometimes takes quite a while, especially if there are a lot of messages or large 
ASD table sizes. To check on the status of the command, enter the following command: 

?AX WHERE 

DUMPANALYZER then displays information regarding the searching process. 
<messages> 

— MESSAGES -| 1 1 

I— EXPAND 1 

\- ALL 

I— LSN — <decimal number> — 



The following text describes the meaning of each construct: 
MESSAGES 



MESSAGES EXPAND 



MESSAGES LSN 
<decimal numbeo 



MESSAGES finds and counts all data comm messages. For each 
station, it displays the number of queued messages along with 
the name of the controlling MCS. Note that if the MCP data 
comm tables were not in memory when the dump was created, 
some of this information might not be available. 

Along with the summary previously described, all DATA COMM 
messages are printed with the header decoded and the message 
text displayed in alpha characters. 

The messages queued for the specified station are printed. 



continued 
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continued 

l 

MESSAGES ALL All message areas are printed. Data comm messages are printed 

as previously described, and other message areas are printed in 
Hex and alpha characters. This report is used for detailed 
analysis of memory area usage. 

Example 

The following is an example of the output from the MESSAGES command: 
INPUT: MESSAGES 

SUMMARY OF MESSAGE AREAS 

756 TOTAL AREAS (4736 WORDS) 

745 NON-DATACOMM AREAS (4472 WORDS) 

11 DATACOMM MESSAGES (264 WORDS) 

1 MESSAGES FOR UNKNOWN LSN'S. (13 WORDS) 

1 MESSAGES FOR LSN 3 (8 WORDS) MCS = 1 SYSTEM/COMS ON 39 

3 MESSAGES FOR LSN 155 (201 WORDS) MCS = 1 SYSTEM/COMS ON 39 

2 MESSAGES FOR LSN 169 (14 WORDS) MCS = 0 
2 MESSAGES FOR LSN 171 (14 WORDS) MCS = 0 
1 MESSAGES FOR LSN 172 (7 WORDS) MCS = 0 

1 MESSAGES FOR LSN 173 (7 WORDS) MCS = 0 

MIX 

The MIX command displays the contents of the process stack or segment dictionary 
stack associated with the supplied mix number. The results are the same as for the 
STACK command. 

<mix> 

— MIX — <decimal number>— r 1 — : — - — 1 

1 — SD — 1 

The following text describes the meaning of each construct: 

MIX <decimal number> The contents of the task stack associated with the supplied mix 

number (<decimal number>) are displayed. 

MIX <decimal number> The contents of the segment dictionary stack associated with the 
SD supplied mix number are displayed. 

For more information, see the discussion of the STACK command in this section. 

MODE 

The MODE command allows the user to control the mode in which words are expanded 
in the MLX and STACK commands. It is also used to control how <simple value>s are 
expanded in the PV command. (Refer to the PV command.) Some of the mode options 
might not be available depending on whether the area was included in the memory 
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dump. For example, if the contents of an array have not been dumped, the command 
MODE + ARRAY cannot display the contents of the array. 



<mode> 
— MODE 



~~ + -j-<mode option>— I" 



<mode option> 



ALL 





ARRAY 




BCL 




CB 




CODE 




DEC 




EBC 




FIB 




FILE 

IDNAMES - 




IOCB 

LIB 




LOCK 

OCT 




PCW 

PIB 




TAB 1 



The following text describes the meaning of each construct: 



MODE? 

MODE+ <mode option > 
MODE- <mode option > 
ALL 
ARRAY 



BCL 



CB 



The current mode or modes are displayed. 
The specified mode is added. 
The specified mode is deleted. 

The ALL modifier is inclusive of all of the following modes. 

If ARRAY mode is used, mom descriptors are expanded subject 
to the limit established by the ARRAYLIMIT command. If the 
array is multidimensional, each dimension is expanded as it is 
encountered. Information concerning the current level is printed 
in the left margin when multidimensional arrays are expanded. 

If BCL mode is used, all operands (Tag 0 words) are expanded to 
show both the hexadecimal representation and the Common 
Language (BCL) representation of the operand. 

If CB mode is used, descriptors referencing connection blocks 
are expanded. 



continued 
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If the CODE option is used, DUMPANALYZER expands and lists 
code areas and read-only data areas. When analyzing a stack, 
the code for return control words (RCWs) is expanded into 
mnemonics for the operators and names of items at the D[0] 
level. 

Op codes for all systems are recognized. An op code that is not 
defined for any of the systems is displayed in the form m*hh, 
where hh is the code syllable in hexadecimal and m is a letter 
indicating the context in which the syllable was encountered: 

• P: Primary (normal context) 

• V: Variant (right after code 95) 

• E: Edit (right after EXSD, EXSU, EXPU) 

If DEC mode is used, all operands (Tag 0 words) are expanded 
to show both the hexadecimal representation and the decimal 
representation of the operand. 

If EBCDIC mode is used, all operands (Tag 0 words) are 
expanded to show both the hexadecimal representation and the 
EBCDIC representation of the operand. 

Expansion of FIBs in the stack is controlled by the FIB option. 
Buffers are dumped and analyzed. 

FIB and FILE are synonyms. 

The IDNAMES mode is used to display identifier name and 
compiler class information along with stack variables. When the 
IDNAMES mode is used, the code file corresponding to a return 
control word (RCW) is checked to determine if BINDINFO 
information is present. Complete BINDINFO information must be 
present to get a display. Currently, only ALGOL, FORTRAN, 
COBOL, COBOL74, and PL/I support complete BINDINFO. To 
create BINDINFO information in COBOL or COBOL74, an 
external procedure declaration must be made. ALGOL, 
FORTRAN, and PL/I generate complete BINDINFO unless the 
program was compiled with the compiler control option 
NOBINDINFO set. FORTRAN77 generates partial BINDINFO 
information when the compiler control option BINDINFO is set. 

IDNAMES mode cannot be used for MCP environments; instead, 
the LOADXREF command must be used. There is no mechanism 

for getting identifier names for environments that are bound into 
the MCP. 

continued 
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continued 



If the code file cannot be found, an RSVP of NO FILE is 
displayed. The following responses are possible: 

• OF: This response cancels the IDNAMES option and the 
following message is displayed: CODEFILE NOT 
AVAILABLE. The line numbers and identifier names are not 
shown. 

• FA: This response changes the file attribute of the code file. 

If the code file that is found has a different creation time or 
date than the code file that was running at the time the 
dump was created, the message WRONG CODE FILE is 
displayed and the user must answer with one of the 
following: 

- OK: This response causes the code file to be used 
anyway. 

RESTART: This response causes CODEFILE to be used 
as the code file. If CODEFILE cannot be found, the "NO 
FILE" RSVP described above is displayed. 

When a correct environment is not found, no identifier name or 
class information can be displayed. Two conditions can produce 
an incorrect environment. Those conditions are 

• When ALGOL was compiled with the 
BEGINSEGMENT/ENDSEGMENT compiler control options 
set. 

• When the use of entry points created packed segments in 
PL/I. 

IOCB If IOCB mode is used, descriptors in the stack referencing an 

IOCB are expanded. 

LIB If the LIB option is used, library structures are expanded and 

analyzed. This applies to both library templates and library 
directories. (Refer to the LIB command.) 

LOCK If the LOCK option is used, the specified value is analyzed to 

determine whether it is a hard lock (tag of 0) or a soft lock 
(tag of 2). 

OCT If OCT mode is used, all operands (Tag 0 words) are expanded to 

show both the hexadecimal representation and the octal 
representation of the operand. 

PIB If PIB mode is used, arrays that have an oddball field of PIB in 

their memory links are displayed as PIBs. 



PCW 



Program Control Word. A word is analyzed as if it were a 
program control word. The expansion of PCWs in stacks is 
optional; normally, PCWs are not expanded, but they are 
expanded if PCW is set. 



continued 
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continued 

TAB If TAB mode is used, arrays that have an oddball field of TAB in 

their memory links are displayed as TABS. 

For more information, see the discussions of the following commands in this section: 

• PV 

• LIB 

• MODE 

Example 

The following is an example of the response to a MODE command: 
INPUT: MODE + ALL 

MODES: SET: EBC BCL DEC OCT PCW LOCK CODE FIB ARRAY LIB IOCB PIB TAB 
IDNAMES CB 
RESET: 

MSCW 

The MSCW command helps to analyze stacks that have a corrupt mark stack control 
word (MSCW) or are in a state in which DUMPANALYZER cannot analyze them 
correctly. 

<mscw> 

— MSCW — FOR — <number>-j- AT — <number>-| 1 

The following text describes the meaning of each construct: 

MSCW FOR <number> The first <number> is the number of the specified stack. The 
AT <number> second <number> is an offset, which must be the location of a 

valid MSCW in the stack. All MSCWs below this MSCW must 
also be valid. The MSCW indicated by <number> is marked off 
in the stack, so that when the stack is examined the following 
message appears in the MSCWs place: 

"MSCW ASSUMED AT THIS POINT BY USER SPECIFICATION" 

An MSCW is reset by setting the second <number> to zero; thai 
is, the offset is zero. 

MSCW FOR <number> ? The setting of the MSCW for the specified stack is interrogated. 
Example 

The following is an example of an MSCW command and the reply: 

INPUT: MSCW FOR 67 AT 51 
STACK 067 MARKED MSCW AT 00051 



4-86 



8600 0478-100 



DUMPANALYZER 



NAMES 

The NAMES command prints the entire list of MCP names and addresses. SORT 
intrinsics are invoked to sort the names alphabetically. While the sort is executing, a HI 
(Cause EXCEPTIONEVENT) system command causes DUMPANALYZER to display 
the message "SORTING MCP NAMES". 

<names> 

_ namES 1 



Example 

Figure 4-18 shows example output for the NAMES command. 
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f 

00 
00 



D 
C 

5 



TO 
C 



00 



m 

CO 

o 
o 

3 

3 
tu 

3 
CL 

o 

c 



00 

cn 
o 
o 

o 

•vi 
oo 



INPUT: NAMES 

IDENTIFIER-ORDERED MCP STACK ADDRESSES FOR *SYSTEM/MCP/39021H ON DISK 
PROCEDURE ADDRESSES ARE SHOWN AS PCW/SEGMENT 



-< 
N 

m 

30 



00C5 A SERIES 10 ALIAS 00C5 

/0731 ARMLSDUMMY ~ 0501 
/17C9 ABORT SELECTION / 
0319/1112 ACCEPT 0262 
0034 ACKNOWLEOGEDMSGLOCK 0033 

/l 120 ACKNOWLEDGEPR I MIT I VEMESSAGES 
/1083 ACQUIREUNITS / 
OOFF ACQUIREUNITWORD 027F/ 

/1A51 AClI VECHECK 1C20 
1912 ADO PROVIDER GROUP LOCAL PCW 

1912 ADO-PROVIOER-PCW ~ OSCE/ 

095C/189A AODROST JACKET / 
0216/1012 AOOSTACKSEARCHEOGEGUTS 07EA/ 
05F8 ADLOCK 0F42 

0EE8 AHW ATTENTION 0EE6 

OEEB/1330 AHW-HANDLIER 0EE5 
0F43, ALA" 02AF 
0135/1007 ALLOCATE 'CODE PARAMETERIZED 
/17E9 ALLOCATE" I OCHRRS STRUCTURE ~ 



A SERIES 10 CELL 
ARUOITREtEASE SUFFIX 
189A ABORTALLOPENS- 

ACCEPT ANY PROCS 
ACKNOWCEOGEOMSGQUEUE 

107C ACOUIREUNITS 
101F ACTIVATE OBJECT 
ACTIVEKF - 

14A1 ADO RESULT 
189A AODROST 
1640 AODSTANDBYHLUNIT 
ADM STARTER 
AHWCOUNT 
AHWHEAD 
ALARMCLOCKT IME 
STRUCTURE 



00C6, A SERIES 102 ALIAS 00C6 
OEC7/12F1 ABNORMALTERMTNAT 10NMESSER 
0B83/1AA9 ABORTJOBLOG 0A9A 
031A/1113 ACCEPTAMSG 0E98/12B6 
0031/1120 ACKNOWLEDGEPR I MIT I VEMESSAGES 

/1021 ACQUIRE /101E 
00E9/1083 ACOUIREUNITS 009C/101E 

/101F ACTIVATE OBJECT /1021 
19C7/19C6 ADD DIRECTORY ENTRY 06CD/1599 
1912 ADD-PROVIDER GROUP PCW /17DD 

06A0/148E ADDALOGICALUNIT ~ 02D9/10D6 

/189A ADDHOST JACKET /16AE 

/173B ADJUST PROV LIST ELEMENT SIZES 
0F41 ADMINISTRATORS ~ 02A9 

0EE4 AHW ENTRY OEEA 

0EE7 AHW-LOCK 0133/1097 

0F44, ALE" 0134/100A 

/17EC ALLOCATE FLAGS 
0136/100A ALLOCATE-MCP ARRAY 0137/100A 



A_SERIES_I02_CELL 

ABQLOCK 
ACCEPTME 

ACQUIRE 
ACQUIRE 

ACTIVATE OBJECT 
ADD DSS TO RESULT 
ADD-PROVIDER GUTS 
ADDGRAPHEDGE- 
ADDHOST_JACKET 

AEVPIB 

AHW HANDLERRUNNING 

AITTNSERT 

ALLOCATE_ARRAY 

ALLOCATE MCP STRUCTURE 



ADDRESS-ORDERED MCP-STACK IDENTIFIERS FOR *SYSTEM/MCP/39021H ON DISK 



/ OENOTES CODE SEGMENT 

/0001 WEXTFUNC 

/0005 ZAPHI 

OOOA GAR NAME CELL 

001C pio- 

0078 OMRREOUESTORMASK 

007C FREEZELIBRARY 

0080 POTL 

0084 LONGSETB ITS 

0088 LOADCONTROL 

008C CANCELLI BRARY 

0090 LINKLIBRARY 

0094 MYSELFER 

0098 FIXHANDLER 

009C ACQUIRE 

OOAO EBCTOASC 

00A4 HEXTOASCII 

00A8 STATCLOCKRESUiME 

OOAC RESETSTRINGPOOLSIZE 

OOBO HIGHESTPNUM 

00B4 SIMPLEWAIT 

00B8 ILOK STATUS 

OOBC ILOK-UNLOCKING 

OOCO FILERTTR IBUTESRABBER 



0002 


STACK 


0003 


ZAPHI 


0004 


WORK 


0007 


ARRAYDEC 


0008 


GAR INFO CELL 


0009 


LINEINFODESC 


OOOB 


GAR CODE OFFSET CELL 


OOOC 


DABMEM ~ 


0014 


MEMDUMP PROC 


004F 


GETTTGOING 


0050 


KERNEL AR REF 


0077 


DCQUEHANDLER 


0079 


BLOCKEXIT 


007A 


GOTOSOCVER 


007B 


MY JOB 


0070 


PROGRAMDUMP 


007E 


TIME INTR INSIC 


007F 


CLOSE 


0081 


POTM 


0082 


POTH 


0083 


ATTRI BUTEGRABBER 


0085 


TRUTHSETS 


0086 


ATTR I BUTEHANDLER 


0087 


USERIOERROR 


0089 


SET GET LIBRARYSTATUS 


008A 


SORT 


008 B 


RES IZEANDDEALLOCATE 


0080 


OPEWP " 


008E 


DELIVERY 


008F 


DESCRIPTORSIZE 


0091 


EBCTOHEX 


0092 


UNRAVEL 


0093 


MUTATE 


0095 


CONTINUER 


0096 


CLOSEP 


0097 


FORKCONTROLCARD 


0099 


OIRECTOR 


009A 


CAUSEP 


009B 


SETORRESET 


0090 


RELINQUISH 


009E 


COMBINEPPBS 


009F 


FORKHANDLER 


00A1 


ASCTOHEX 


00A2 


ASCTOEBC 


00A3 


HEXTOEBCDIC 


00A5 


READLOCKTIMEOUT 


00A6 


CLOCKOFFPCW 


00A7 


STATCLOCKON 


00A9 


STATCLOCKSUSPEND 


OOAA 


GETSTR INGAREA 


OOAB 


GETSTRINGPOOLSIZE 


OOAO 


ARRAYSEARCHP 


OOAE 


GETLIBATTRIBUTES 


OOAF 


SETLIBATTRIBUTES 


00B1 


HAPPENEDP 


00B2 


AVAILABLE? 


00B3 


MULTIWAIT 


00B5 


DELINKLIBRARY 


00B6 


OESC HIDING 


0087 


ILOK OK 


00B9 


ILOK BREAK 


OOBA 


ILOK"ARROGATE 


OOBB 


ILOK-LOCKING 


OOBD 


FA JACKET 


OOBE 


MCPHRNDLEERROR 


OOBF 


F I LERTTR I BUTEHANDLER 


00C1 


BAOUNLOCKOUMP 


00C2 


JUSTEX ITANDUPDATE 


00C3 


PURGE SEB INCLUDING MY AR 



o 
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NSP 

The NSP command is similar to the DC command except that it analyzes only the NSP 
tables, not the DCC tables. 

<nsp> 

_ NSP , 1 

' — MSG — ' 

The MSG option causes messages in nontanked data comm queues in the DCALGOL 
queue to be analyzed. 

For more information, see the discussion of the DC command in this section. 
Example 

Figure 4-19 shows example output for the NSP command. 
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INPUT: NSP 



NSP DATACOM CONFIGURATION 
MAXIMUM LSN 
CONFIGURED 
INITIALIZED 
NSPO1O7/O0 



RELATIVE NSP NUMBER S 
RELATIVE NSP NUMBERCS 
UNIT TAKEN, MAXLINES=_., 
NSPOllO/Ol : UNIT TAKEN, MAXLINES«15 
NSP0109/03 : UNIT TAKEN, MAXLINES«31 
NSPOlll/04 : UNIT TAKEN, MAXLINES=47, 



DATA COMMUNICATIONS ANALYSIS 



712 

0, 1, 2, 3. 

5, Die $NR=06E 

DCC SNR=06D 

DCC SNR=06C 

DCC SNR=068 



NSP TABLE ANALYSIS FOR NSP 0 



NSPSTATUS 0:0 006B0F C0006E 
NSPMASTER.O: 5 800001 0043B5 



LINE 
LINE 
LINE 
LINE 
LINE 4 
LINE 5 
LINE 6 
LINE 7 
LINE 8 
LINE 9 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 



DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 

10 DESC 

11 OESC 

12 DESC 

13 DESC 

14 DESC 

15 OESC 



OOODOO 1002FF 
OOODOO 100302 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 



MAXLINES»15. UNIT=107. UNIT TAKEN, OCC SNR » 06E 
(DATA DESC TO LINE VECTOR) 



NSP TABLE ANALYSIS FOR NSP 1 



NSPSTATUS 1:0 006E0F C0006D MAXLINES=15. UNIT=110, UNIT TAKEN , DCC SNR = 060 



NSPMASTER 1 
LINE 0 DESC 
" 1 
2 
3 
4 
5 
6 
7 



LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 8 
LINE 9 
LINE 
LINE 



DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 
DESC 

10 DESC 

11 DESC 



LINE 12 DESC 



800001 00438E 
0 001000 000305 
" OOOAOO 100316 
000800 000327 
001000 000338 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 
000000 200000 



(DATA 6ESC TO LINE VECTOR) 



000000 200000 
000000 200000 
000000 200000 
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Figure 4-19. NSP Command Output 
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OLAYINFO 



The OLAYINFO command analyzes overlay file allocation. This command is used when 
overlay file corruption is suspected. 

<olayinfo> 
— OLAYINFO 



OVERLAY 
FILE — 
AREA — 



The following text explains the meaning of each construct: 

OLAYINFO DUMPANALYZER finds all ASD table entries that are in overlay 

disk, or are in the process of reading or writing from the overlay 
disk. DUMPANALYZER also checks for overlapping and 
compares the bit vectors. 

OLAYINFO OVERLAY If OVERLAY is specified, all data of the whole overlay structure is 

displayed. This includes the size of the areas, number of 
overlayable segments, number of pack names used, number of 
areas in use, number of files, and so forth. 

OLAYINFO FILE If FILE is specified, all data for each of the files is displayed 

separately. This includes the number of sectors per record, 
records per area, allocated records, in-use records, and so forth. 

OLAYINFO AREA If AREA is specified, all data for each area or disk row is 

displayed. This includes the unit number base address, number 
of records in use, and so forth. 

Example 

The following is an example of the output from the OLAYINFO command: 
INPUT: OLAYINFO 

CURRENT_OVERLAY 0 000000 000007 ( 7 ) 

OVERLAY_MANAGER (7) 5 800001 903E15 

. FOR 2 SECTORS THERE ARE 1486 SEGMENTS, OVERLAY ALLOCATED 1488 
. FOR 5 SECTORS THERE ARE 22 SEGMENTS, OVERLAY ALLOCATED 23 
. SUM OF ALL SEGMENTS WITH PROBLEMS 2095, SUM OF ALLOCATED 2098 
OTHER OVERLAY_MANAGER (6) 5 000001 900001 



OPT 

The OPT command lists the compile-time and run-time option settings and module 
alternatives selected when the dump was created. 

<opt> 

_ opt : 1 



Example 

Figure 4-20 shows an example of the response to the OPT command. 
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INPUT: OPT 
OPTIONS: SET 



COMPILETIME OPTIONS SET 
ASOOEBUG 
DIAGNOSTICS 
EXPERIMENTAL 
L INEINFO 
LOCKTRACE 
REAOLOCK 
READLOCKTIMEOUT 
RESTART 
TRACE 

CATALOGLEVEL » 0 



HOOULE ALTERNATIVES SELECTED: CPIOHOU SOFTPROCSWITCHING BLOCKEXIT_BMS PORTS_BNAVl INITFILEJJIO UPIO CONF IGCONTROL70 
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PATHCNTRL (Selected EMS Systems) 

The PATHCNTRL command provides an analysis of the PATHCNTRL table used on 
EMS systems. The PATHCNTRL table contains information on the access pathways to 
I/O peripherals. Each entry in the table consists of a PATHNODE node and one or 
more related PATHENTRY nodes. This command displays information for both types 
of nodes in an entry. 

The PATHCNTRL command is valid only for dumps generated on EMS systems that 
use A Series I/O rather than pre-A Series I/O. 

<pathcntrl> 

— PATHCNTRL -, . 1 

■—UNIT — | i-<decimal number>— ' 

L LOG - 1 

The following text describes the meaning of each construct: 

PATHCNTRL Every entry in the PATHCNTRL table is analyzed. All units 

referencing a given PATHNODE are displayed, and the 
PATHNODE and each associated PATHENTRY are analyzed. 

PATHCNTRL UNIT The PATHCNTRL table entry is analyzed for the specified 

<decimal number> peripheral unit. The <decimal number> corresponds to the 

physical unit number of the peripheral. Physical unit numbers 
are the numbers used to identify peripherals in various system 
commands such as PER (Peripheral Status) and RY (Ready). For 
example, the command READY MT 29 readies the tape drive 
whose physical unit number is 29. 

PATHCNTRL UNIT LOG The PATHCNTRL table entry is analyzed for the specified 

<decimal number> peripheral unit. The <decimal number> corresponds to the 

logical unit number of the peripheral. Logical unit numbers are 
used internally by the MCP and appear only in memory dumps. 

Example 

Figure 4r-21 shows an example of the first page of the response to the PATHCNTRL 
command. 
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INPUT: PATHCNTRL 

ANALYZING ENTIRE PATHCNTRL TABLE 9 00019831; 160 WORDS IN TABLE 
** THIS PATH NODE STARTS AT PATHCNTRL[1] ** 



PK44 LOGICAL UNIT 
PK45 LOGICAL UNIT 
PK46 LOGICAL UNIT 
PK47 LOGICAL UNIT 
PK48 LOGICAL UNIT 
PK49 LOGICAL UNIT 
PK50 LOGICAL UNIT 
PK51 LOGICAL UNIT 



»: 

8. 



THESE 8 UNITS ACCESSED VIA: 



PATHNOOE : 
PATHENTRYMASK: 
PATHAVAILMASK: 
PATHNOOE INFO: 
PATHNOOEQINOX: 



200000J80002 ?S?§s°?N}AY D Ws{IS^2 ST 25 A ? E pi!?S? L f 0EVICE (PAac) - PATH SIZE " 5 - H00E SIZE ' 5 - FW DIGITS - 10 



AOOi 



JOOOO UNIT Q IN0EX-0003 



** PATH EHTRY 1, STARTS AT PATHCNTRL[6] ** 



PATHENTRYSTART: 
PATHENTRYINFQ: 
PATHENTRYINF02: 
PATHENTRVFW: 
PATHENTRYQIMOX: 



S04000000000 

rooooooooooi 

101080104030 
JOOOOOOOOOOO 



CONTROLLING DLp'o' I ° P " 1 ' I0P P0RT *°* LEM "°« REL 0U>b5 ' ONLINE, H Q PRESENT 

§tp EA f!SSwS^ N i:|y?i ?S?1S§8o?o3oS NDEX * 001 ' H 9 00PE VECT0R ,NDEX " 00 ' H Q SL0T IN0EX - 1 

** FOR NON A SERIES I/O ONLY ** 



THIS PATH NODE STARTS AT PATHCNTRL(11] ** 



SC128 
SC129 
SCI30 



SC134 
SC135 

m 

SC138 
SC139 
SC140 
SC141 
SC142 
SC143 



LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 
LOGICAL 



UNIT 14 
UNIT 15 
UNIT 16 
UNIT 17 
UNIT 18 
UNIT 19 
UNIT 20 
UNIT 2| 



UNIT 
UNIT 
UNIT 24 
UNIT 25 
UNIT 26 
UNIT 27 
UNIT 28 
UNIT 29 



THESE 1.6 UNITS ACCESSED VIA: 

MmE?K«Hi ffio« P v S?SI 0 ?^RY D fcAs«S§5^ p .>°5 E ?Sf 0 H? S I5PLAY ' PATH s,ZEs5 ' N00E SIZE " 5 « FW DIGITS '° 

PATHAVAILMASK: 300000000002 PATHS AVAILABLE MASK-0002 => NONE UNAVAILABLE 



DUMPANALYZER 



PATTERN 



The PATTERN command is used to set or examine the pattern register. The pattern 
register stores a distribution of Is and Os in a 48-bit word and its 4-bit tag. The pattern 
assigned by the PATTERN command is stored until changed by another PATTERN 
command. 



The PATTERN command and the MASK command are used to provide information 
for use by the SEARCH command. The SEARCH command searches the dump for all 
words that match the pattern register, bit for bit. The MASK command must be used 
to mask off some of the bits in the pattern as not significant to the search. (Refer to the 
MASK and SEARCH commands for further information.) 

<pattern> 

— PATTERN -i 1 1 

I— <simple va1ue>— I 



The following text describes the meaning of each construct: 

PATTERN If no <simple value> follows PATTERN, the contents of the 

PATTERN register are displayed. 

PATTERN <simple The pattern register is loaded with <simple value>, which can 

value> then be used as a nonvolatile search pattern. 

The pattern includes the 4-bit tag for a word. To specify a TAG, the concatenation form 
of simple value is used; input would specify 12 hexadecimal digits & <number> TAG. 
The tag value should be no larger than 15; however, if it is larger than 15, the tag value 
is placed in the tag using modulus 16. If no tag is specified, the tag is assumed to be 0. 

Although the pattern represents 48 binary bits and a tag value of four binary bits, the 
pattern is displayed and is most often set in hexadecimal. Figure 4-22 shows a diagram 
of a pattern word, with its hexadecimal equivalent stated below it: 



bit* 



47 


0 


0 


0 


0 


0 


0 


0 


0 


1 






1 


46 


0 


0 


0 


0 


1 


1 


0 


0 


1 






1 


45 


0 


0 


0 


0 


0 


0 


1 


1 


1 






1 


44 


0 


0 


0 


0 


0 


0 


0 


0 


1 






1 ; 




0 


0 


0 


0 


4 


4 


2 


2 


F F F 


F 



Figure 4-22. Pattern Word Example 



To put the pattern of bits shown in the word above into the pattern register, the 
corresponding pattern command would be PATTERN 4422FFFF & F TAG (it is 
understood that there are four leading zeros). The pattern register would display its 
contents as F 000044 22FFFF. 



8600 0478-100 



4-95 



DUMPANALYZER 



The default for the PATTERN register is displayed as 0 000000 000000. 

Examples 

INPUT: PATTERN 
PATTERN: 0 000000 000000 

INPUT: PATTERN 23000EC05B72 
PATTERN: 0 23000E C05B72 

INPUT: PATTERN 123456789ABC & DEC 10 TAG 
PATTERN: A 123456 789ABC 

For more information, see the discussion of the MASK and SEARCH commands in this 
section. 



PC or PRINTCODE 

The PC or PRINTCODE command translates code words into their mnemonic 
equivalents and prints the results. 

<pc> 

— i— PC 1— <simple address>— i 1 -> 

L PRINTC ODE - 1 L : — <PWI>- J 

L FOR — <simple value>— ' L. |_|_ — <lex level>—J ' 

Translation of code begins on or before the designated < simple address >, which is the 
segment base. Translation of code ceases when both of the following conditions are 
true: 

• The length specified is achieved. 

• The instruction word is complete. 

The <PWI> construct is a number that specifies a location relative to the segment 
base. The default value for <PWI> is 0. 

If no FOR <simple value> construct is specified, the default length is three words. 

The <lex level>, a number, indicates the running environment level. If it is not 
specified, a lex level of 3 is assumed. If the lex level of the running environment is not 
3, the lex level must be specified to ensure proper interpretation of operators that 
contain address couples, such as NAMC and VALC. 

Non-tag-three words are translated, but DUMPANALYZER displays a warning 
indicating that the word being analyzed is probably not code. 

All display headings (such as, in the example, the lines from CODE ANALYSIS: to the 
underline) are suppressed from remote output but appear in the printer output. 
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PIB 



Example 

INPUT: PC 14325:124. FOR 3 
CODE ANALYSIS: 

SEGMENT BASE 
WORD OFFSET 
LENGTH 
LEX LEVEL 

PWI:PSI MNEMONICS 



14325 
00124 
00003 
3 

HEX CODE 



0125:0 RSNR 

0125:2 INSR 46:15 

0125:5 NAMC 00.01BB 

0126:1 RDLK 

0126:3 DUPL 

0126:4 BRFL 0D08:5 



9581 
9C2E0F 

41BB MEMLOCK 

95BA 
B7 

A0AD08 



For more information, see "Simple Address" and "Multiple Address" in this section. 



The PIB command prints the contents of a process information block (PIB), which is a 
task variable associated with a process stack. If a word within the PIB is specified, only 
that word is printed. 



<pifc» 
— PIB 



-<number>- 



i- AT — <simple address: 
L- VIA — <ASD number> — 



-<PIB cell name>— 
L- # — <offset>- 



The following text describes the meaning of each construct: 
PIB <number> 



PIB AT <simple 
address> 



The PIB associated with the stack specified by <number> is 
printed. 

The PIB located at memory address <simple address> is 
printed. 



PIB VIA <ASD number> The PIB located at <ASD number> is printed. 

When <PIB cell name> or # <off$et> is used, only the specified word within the PIB 
is printed. For more information about tasks, refer to the TAB command. 



Example 

Figure 4-23 shows an example of the first page of the response to the PIB command. 
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INPUT: PIS 34 

SPIBVECT0R[034] « 5 800005 B03273 



00 




3 


012000 


01 




0 


000000 


02 




0 


000000 


03 




0 


000000 


04 




0 


400000 


05 




0 


000000 


06 




0 


000000 


07 




0 


000000 


08 


-0C 


0 


000000 


00 


•11 


0 


000000 


1? 




7 


000079 


13 




1 


000327 


14 


15 


0 


000000 


16 




0 


000340 


17 




0 


000000 


18 




0 


800000 


19 


10 


o 


000000 


IE 




0 


4E3845 


IF 


20 


0 


899922 


l\ 
22 
23 




1 

0 
B 


012000 
000000 
C32000 


24 


26 


0 


000000 


27 




0 


000000 


28 

2C 


•2B 


0 
0 


000000 
034000 




\\ 


0 


000000 


32 


-36 


0 


000000 


37 


-39 


0 


000000 


Jn 




5 


800003 


38 




0 


000000 


3C 


-40 


0 


000000 


41 




0 


000000 


42 




7 


273100 


43 




1 


000327 


44 




7 


2730F8 


45 




1 


000327 


46 




0 


000000 


47 




0 


000000 


48 




0 


000000 


49 




0 


000000 


4A 




0 


400000 


4B 


-4C 


0 


000000 


40 




0 


400000 


4E 


-52 


0 


000000 


53 




0 


007FFF 


54 




0 


007FFF 


55 




0 


000000 


56 




B 


C32000 


57 


-58 


0 


000000 


59 




5 


800004 






TAB 



00 

01-02 

03 

04 

05-09 
OA-OE 
OF-13 
14-18 



844000 
000000 
000012 
000000 
004E18 
0001DC 
00010C 
0001DC 
000000 
000000 
E89008 
3C0012 
000000 
000000 
000000 
000000 
000000 
79708C 
000000 
84026C 
000000 
000040 
000000 
000063 
000000 
000000 
000000 
000000 
000000 
A03276 
000002 
000000 
000000 
189021 
3C0042 
B89021 
3C0044 
002000 
000000 
000005 
000000 
564C7A 
000000 
000455 
000000 
FFFFFF 
FFFFFF 
000000 
000041 
000000 
F03274 



400000 5640FA 
000000 000000 
000000 000003 
000000 000455 
000000 000000 
000000 000000 
000000 000000 
000000 000000 



PIBMSCW 

COOEHEAOERS 

COOELINKS 

COHPILERINFO 

COREINTEGRAL 

COREINUSE 

C0RE1NUSESAVED 

MAXSAVEMEMORYUSEO 

ASOSINUSE 

0LAYSACT1 VE 

WS PALACE 

WS-PALACEREF 

0B5INFO 

BOINFO 

EVENTCAR 

BEOWORD 

EVENTCOUNT 

80TTIMESTAMP 

CPINFO 

ENTRYPOINT 

RESTARTRCW 

EXCEPTIONEVENT . 

( EXCEPT I0NEVENT2) 

HEADERACCESS 

INSTRETRYINFO 

JOBINFO 

JOBMSGS 

REMPR INTMASK 

ROLLOUTINFO 

PIBIOCB 

TASKTYPE 

WAITSTART 

RECENTPROC 

PALACE 

PALACEREF 

HOVEL 

HOVELREF 

USAGE 

DMSBEO 

READYON 

PROCESSOR 

CLOCKONTIME 

LETGEORGEOOIT 

PROCESSTIME 

IOTIME 

MAXPROCESSTIME 
MAXIOTIME 
MISCINFO 
PIBEVENT , 
[PI BEVENT2) 
TASKING TAB 



SEG OICT = 012 

. -19992 
* 476 
» 476 
» 476 

|ea«cSU"o se JHSSEifl"' §???SSI?SS?ES , SbS«S5 l o U »T 

YOURNAME 



BLOCK 



ALARMTIMES 



K 

= 01/24/90 12:25:59" 
OCKEYPIBINFO 
SIRW: OFFSET=0274 (0008+026C) STACK 

EVENT 00040 NOT HAPPENED 
EXTERNALFAMILYLIN FREEPBITS 



ASSUMEIOTIME ASSUMEPROCESSTIME 
= 012 (PCW) READYQINSERT 



INTERCEPTEORCW 

LIBRARYSTATUS 

REMPUNCHMASK 

SOFTINTQ 

ORCPIBINFO 



INTERCESSION 

PIBL0CKS47 

REPLY 

TASKINFO 

PRTABLE 



JOBDECKINFO 

P0RTL1B PIB 
REPLYEVENTX 



ACTIONBITS 



PROCESSFAMI LYLINK 
(REPLYEVENT2) 



ACTIONQHEAD 



i$W: WFfiT2|i8j2!fgg^}!|?}|JgJt?- S5B STATE U4650720) »W"MTAC1CPR0C$ 



PCW: LL*2. D[0 
' RW: OFFSET=00 , , „ v 
NOTINHERITMCSSTATUS 

9 0:00:00 AFTER HALTLOAO 



5IS*i.S.FFSfl?b8i!4?f83a^ IM STATE (1465 ° 720) ""ATESTACKPROCS 

202.308679 SECONDS PRIOR TO DUMP 
188.735074 5EC0NDS PRIOR TO DUMP 



9 0:00:13 AFTER HALTLOAD 
READYTIME 
« -0.0026616 SECONDS 

VO kS2¥£I.,*.., OFFSPRINGACCOUNTS FILEACCOUNTS 
= 549755813887 
= 549755813887 

EVENT 00041 NOT HAPPENED 
MLINFO 



VALIDITYBITS 



liU°ik\h$ niR HALTL0AD 3 188 ' 734152 SEC0NDS PRI °« T ° W» 

INITP8ITK0UNT = 3 

INI TPBITTYME = 0.0026616 SECONOS 

I0C0UNT1 I0C0UNT2 HISTORY IOTIMETAB 

8TSIR5li TCOU " T 8I H i§ P , B,TTIHE PROCESSTIME STOPPOINT 

DISKUSEO HSINFO ITINERARY LINESPRINTED 

TASKPARAMS TEMPF I LEMBYTES WFLJOBINFO ACCESSCOOE 



MYSTACKHISTORY 
CAROSPUNCHED 
SURROGATE INFO 
BACKUPFAMILY 
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PORT 

The PORT command prints an analysis of a port file. A system response of PORT 
OVERLAYED implies that the port file was not in memory when the dump was created. 

<port> 

— PORT -T-<port index> 1 1 

j— AT — <address> 

L- VIA — <ASD number^ 



The following text describes the meaning of each construct: 



PORT <port index > 



PORT AT < address > 



PORT VIA <ASD 
number> 



The <port index > value is an index into the PSS array, which is 
a two dimensional, global data structure maintained by the Lists 
Module of the MCP. The user can determine the location of the 
PSS array by using the command MD G PSS. 

The PORT <port index> command actually selects PSS 
[<index>,*] structures, only some of which are ports. 
DUMPANALYZER verifies that the <port index> points to a valid 
PORT structure by checking word 0, field [47:32] of the element 
selected (PSS [<index>,0].[47:32]). If this field contains 
"PORT" and field [15:16] of the same word is equal to <port 
index >, then the element selected is a valid PORT and is 
analyzed. If not, a "BAD PAB" message is displayed. 

The <port index > is stored in the LIBRARYINFO word of a FIB 
using the PORT. 

The port at the given absolute memory address is analyzed. If 
the memory address specified does not contain a port data 
structure, then DUMPANALYZER displays the message "BAD 
PABNO". 

The port at the address referenced by the supplied ASD number 
is analyzed. If the address referenced by the supplied ASD 
number does not contain a port data structure, then 
DUMPANALYZER displays the message "BAD PABNO". 



Example 

The following is an example of the first page of the response to the PORT command. 
The dump was created on a system running BNA Version 2. 

INPUT: PORT 54 

PORT ATTRIBUTE BLOCK DESCRIPTOR AT 5 800001 D0265C 



00(00) 0 D7D6D9 E30054 MY PORT ADDRESS =84(54) 

01(01) 0 003200 000000 MAXSUBFILES =50(32) 

LASTSUBPORT =0(0) 

SERVICE =0(0) 

02(02) 0 23D004 000000 MAXRECSIZE =9168 (23D0) 

PREFERREDCHARSET =4(4) 

REMOTERRF =0(0) 

TRANS LATEATT =0(0) 

DEF_DIALOG_PR_ATT =0(0) 
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03(03) 0 000000 000109 



04(04) 0 000000 3205A0 



05(05) 0 000500 000180 



06(06) 0 010300 000000 



07(07) 0 000001 000002 



08(08) 0 000000 000003 



09(09) 0 000000 000000 
10 (0A) 0 000000 000000 
11 (0B) 0 001900 1A001B 
LIST NUMBER: 27 



FIRSTCHANGEDSUBFILE 
HOSTSERVICESDIALOGNO 
OLDYOURUSERCODE 
WAITFOROPEN 
SOMEERROR 
ATTACHED_TO_PLM 
BNAV2 PLM PORT 
TTP_PORT 
SYNC_PORT 
SERVICE ATTRIBUTE 
OPENEDSUBPORTS 
CLOSEDSUBPORTS 
PORTOWNERSTACK 
PROGRAM AGENT 
NETEX PORT 
RETIRING 
IOWNYOURLOCK 
PORT_EVENT_NUM 
READABLESUBPORTS 
USING PROCESS TYPE 
WORD_ORIENTED 
TTP_IX 

SECURITYTYPEATT 
FRAMES IZEATT 
INTERFACE MODEL 
PORTSTATEEVENT 
5 670000 0002C6 
0 000000 000000 
MESSAGEEVENT 
0 000000 000000 
0 000000 000000 
INTERNALEVENT 
5 610000 0005 5 B 
3 000000 00008D 
PORTLOCK 
0 000000 000000 
0 000000 000000 
PORTLOCKWORD 
PORTGRABWORD 
MESSAGE FORWARDING LISTS 
NO OF ELEMENTS i 0, 



=0(0) 
=0(0) 
=TRUE 
=FALSE 
= FALSE 
=FALSE 
=FALSE 

=1(1) 
=0(0) 
= FALSE 
=0(0) 
=50(32) 
=90 (5A) 
=FALSE 
= FALSE 
=FALSE 
=FALSE 
=5(5) 
=0(0) 

=KD 
=TRUE 

=KD 
=3(3) 
=0(0) 
=0(0) 
=KD 



EVENT ANALYSIS: 
=2(2) 

EVENT ANALYSIS: 
=0(0) 

EVENT ANALYSIS: 
=3(3) 

EVENT ANALYSIS: 
=0(0) 
=0(0) 



PRINTARRAY 

The PRINTARRAY command prints an entire array or part of an array, depending on 
the setting of the ARRAYLIMIT command. To print a present array, use either version 
of the PRINTARRAY command. To print an overlayed array from a program dump file, 
use the VIA attribute of the command. 
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<pn"ntarray> 

— PRINTARRAY -> r <simple address>- 

— AT — ' 

L VIA — <ASD index> 



The following text describes the meaning of each construct: 

PRINTARRAY <simple 
address> 

PRINTARRAY AT Either of these formats will print all or part of an array at the 

<simple address> given memory location. 

PRINTARRAY VIA <ASD This format prints all or part of an array at the stack location 

index > indicated by <ASD index >. 

An array can be printed by three different routes: 

• The ARRAY attribute of the MODE command can be set to TRUE; arrays are 
printed in the normal course of printing a stack. 

• The PRINTVALUE command can be used to print present arrays. 

• The PRINTARRAY command can be used to print both present and overlayed 
arrays. 

Note: Overlayed arrays are available only when a program dump to a disk 
file is being analyzed. The arrays are not dumped during memory 
dumps. 

For more information, see the discussion of the following commands in this section: 

• ARRAYLIMIT 

• MODE 

• PV 



PRINTER 

The PRINTER command routes output to the line printer instead of to the terminal 
or a disk file. The standard DUMPANALYZER header page is printed as a preamble. 
Each command that causes the information to be dumped is also printed. 

<printer> 

— PRINTE R 1 

Printer output from DUMPANALYZER includes both upper case and lower case 
letters. If DUMPANALYZER output is directed to a printer that does not support lower 
case letters, then a transform function such as the UPPERCASE standard transform 
function should be used to translate lower case letters to upper case. For information 
about print transforms, refer to the A Series Print System (PrintS/ReprintS) 
Administration, Operations, and Programming Guide. 
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PRINTVAL 



This command is a synonym for the PV (or PRINTVAL) command. Refer to the PV 
command. 



PROC (EMS Systems) 



Note The PROC command has been deimplemented. This command had 
meaning only on systems with ASN memory, which is not supported 
on the Mark 3.9 system software release and later releases. 



PROCS 



The PROCS command causes all processors that were running on the system (both 
E-mode and IOP) to be displayed. This command is valid only for dumps executed on 
Micro A, A 1, A 2, A 3, A 4, A 5, A 6, and A 10 systems. 

<procs> 

— PROCS 1 



Example 

INPUT: PROCS 

PROCESSORS CURRENTLY ON THE SYSTEM ARE: 
EMP #9 IN STACK 0A6 S=>0008E7B5 



PROCSTACKS 

The PROCSTACKS command displays the contents of each stack that has a processor 
currently on it. The stack that requested the memory dump is also displayed. The 
contents of the stacks are formatted and interpreted before they are displayed. 



The STACK ACTIVE form of the STACK command provides more flexibility than the 
PROCSTACKS command. 

<procstacks> 

— PROCSTACKS : 1 



For more information, see the discussion of the STACK command in this section. 



PROGRAMDUMP 

The PROGRAMDUMP command prints the contents of stacks that have been 
dumped. The function of this command is to produce a listing similar to that of the 
PROGRAMDUMP command in ALGOL and other language compilers, and therefore is 
intended to be used with program dumps that were directed to disk. The content of the 
output is determined by the options specified at dump time and by the parameters of 
the PROGRAMDUMP command. 
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<programdump> 



— PROGRAMDUMP 



- ALL — 

- ARRAY - 

- ARRAYS 

- BASE - 

- CODE - 

- DBS — 

- FILE - 



- FILES 

- LIBRARIES 



PRIVATELIBRARIES 



The following text describes 
PROGRAMDUMP 
PROGRAMDUMP ALL 

PROGRAMDUMP ARRAY 

PROGRAMDUMP 
ARRAYS 

PROGRAMDUMP BASE 

PROGRAMDUMP CODE 
PROGRAMDUMP DBS 
PROGRAMDUMP FILE 
PROGRAMDUMP FILES 



PROGRAMDUMP 
LIBRARIES 

PROGRAMDUMP 
PRIVATELIBRARIES 



the meaning of each option: 

The stack for the clumping task is printed. 

This option is equivalent to specifying all available options for 
the PROGRAMDUMP command. 

All arrays in selected stacks are printed. 

The base of the stack and the process information block (PIB) 
for all selected stacks are analyzed and printed. 

The segment dictionary stack for the dumping task is printed. 

All database stacks in the dump file are printed. 



All file information blocks (FIBs) in the selected stacks are 
analyzed and printed. The buffers associated with each file are 
also printed. Note that this option does not print disk file 
headers. The HDR command can be used to analyze disk file 
headers. 

All library stacks in the dump file are printed. 



All private library stacks in the dump file are printed. 
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PV 



The PV or PRINTVAL command displays the specified < simple value > or the specified 
word in the current stackwindow in several possible forms. 



<pv= 



-i— PV , — r-<simp1e value>- 

L PRINTVAL — I I— sw 



IT 



coffset: 



<mode option>- 

- TIME6 

- TIME11 

TIME14 

MODE 

RCW 

I- EBC 



r 



ARRAY - 



DESC 



The following text describes the meaning of each construct: 

PV <simple value> The specified <simple value> is displayed in hexadecimal form. 



PV SW 

PV SW # < offset > 



<mode option > 
TIME6 

TIME11 

TIME14 



MODE 



This syntax is valid only if the STACKWINDOW command has 
previously been used. The word that the current stackwindow 
centers around or the word in the current stackwindow with the 
specified offset is expanded. 

The specified word is displayed in the desired <mode option >. 
(Refer to the MODE command.) 

In the TIME6 mode, the specified word is analyzed as if it were 
a TIME(6) format word. This word has the following format: 0 & 
(JULIANDATE-70000) [47:16] & (TIME(ll) DIV 16) [31:32] 

In the TIME11 mode, the specified word is analyzed as if it were 
a TIMEQ 1) format word. This word stores the time of day, 
expressed in multiples of 2.4 microseconds. 

In the TIME14 mode, the specified word is analyzed as if it were 
a TIMEU4) format word. This word stores the time elapsed 
since the last halt/load in multiples of 2.4 microseconds. 
DUMPANALYZER appends the following message to the 
analysis: "SINCE LAST HALT/LOAD". 

Displays the specified word in the modes that are currently set. 
(Refer to the MODE command.) 

In the FIB mode, <simple value> is expanded as a FIB. 
<simple value> must be a present descriptor. If the length field 
is incorrect, a warning message indicating that the value is 
probably not a FIB is displayed. 

In the IOCB mode, the IOCB word in the base of the stack and 
any descriptor can be analyzed as an IOCB. 



continued 
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continued 



On HDL) systems, the PV command in the IOCB mode analyzes 
both lOCBs and HCBs. The word whose contents are <simple 
value> is a descriptor that might refer to either an IOCB or an 
HCB. If the descriptor refers to an IOCB and an HCB has been 
allocated for that IOCB then both structures are analyzed. Word 
three of the structure pointed to by the descriptor is checked to 
determine if the descriptor is for an HCB or an IOCB. If the tag of 
the word is 5 (indicating that it is a data descriptor), then the 
word is assumed to be the HCB Self Pointer and the descriptor is 
assumed to point to an HCB; otherwise, the descriptor is 
assumed to point to an IOCB. 

If the MCP option READLOCK is set, each hard lock is shown 
with sequence number and procedure name in the LOCK mode. 

In the construct "PV M[a] . . .", if M[a] and M[a + 1] are both 
Tag-2 words, they are analyzed together as a double operand. 
This construct is effective in DEC, OCT, BCL, EBC, or LOCK 
modes. 



RCW 




EBC ARRAY 



DESC 



In the DESC mode, the specified word is analyzed as if it were a 
data descriptor. 



For more information, see the discussion of the MODE and STACKWINDOW 
commands in this section. 



Example 



The following are examples of the output from the RCW option of the PV command: 



INPUT: PV 00081DF8501E RCW 

0 00081D F8501E RCW G> 101E:01DF:4 (12632400) MULTIWAIT 



INPUT: PV 80000020323D 7 5 TAG EBC ARRAY 
5 800000 20323D 

0(0000) 0 C1C2C3 C4C5C6 0 C7C8C9 D1D2D3 ABCDEF GHIJKL 



QUEUE 



The QUEUE command displays DCALGOL queues. 



<queue> 



— QUEUE 
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The following text describes the meaning of each construct: 



QUEUE 



If no <number> is specified, displays all DCALGOL queues. 



QUEUE <number> 



Displays the indicated queue. 



BUSY 



Displays all queues that have messages. 



MSG 



Displays all data comm messages in the selected queues. 



ALL 



Displays all messages in the selected queues, including any 
messages that are not data comm messages. 



Example 



Figure 4-24 shows an example of the response to the QUEUE command. The following 
are explanations of some items in the example: 

• Each entry in the QUEUE NUMBER column identifies the start of a queue stack, 
which is a nonrunning stack of descriptors referencing the actual queue. 

• If the QMSGINFO entry in a queue stack ends with a series of asterisks 
(**********), then there are messages to be removed from the queue. The 
MSGCOUNT item in the entry indicates the number of messages to be removed. 

• The QTIBDESC entry is the queue task information block. 
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INPUT: QUEUE 



OUMPOF OCALGOL QUEUE STACK(FFE) 
NUMBER 



5 800002 100FFE 



0000 5 800000 003694 



(QUEUE AOOR 
0000 



0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
OOOA 
000 B 
OOOC 



.... « QOO2C05F 
000885 80116C 
000370 000001 
000009 oooooc 

000000 031000 
000000 050BB8 
. 000000 000000 
B C32000 OO00B9 
0 000000 000000 
B C32000 OOOOBA 
0 000000 000000 
0 000000 000000 
0 000000 000000 
0 000000 000000 



OOOC 5 800000 003 SCE 



(QUEUE AOOR * 00025EAC 

0000 0 000000 000000 

0 000370 0C0001 

0 000000 000000 

0 000000 0003E8 

0 000000 050BB8 

0 000000 000000 

B C32000 0000A5 

0 000000 000000 

B C32000 0000A6 

0 000000 000000 

0 000000 000000 

0 000000 000000 

0 000000 000000 



0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
OOOA 
OOOB 
OOOC 



OOOB 5 800000 003 5CA 



OOOA 5 800000 D03290 



(QTAIl»08B58, QHEAD* 
ACTIVATING SNR-037, USE 



MSG! NFO (MSGCOUNT-3, MEMORYL 

BLOCKS I ZE-3000) 




6) 



(QUEUE AOOR ' 000260F8) 

0000 0 000000 000000 

0001 0 000370 0B0001 

0002 0 000000 000000 

0003 0 000000 0003E8 

0004 0 000000 050BB8 

0005 0 000000 000000 

0006 B C32000 0OOOA3 

0007 0 000000 000000 

0008 B C32000 0000A4 

0009 0 000000 000000 
OOOA 0 000000 000000 
OOOB 0 000000 000000 
OOOC 0 000000 000000 

(QUEUE AOOR = 00027D4C) 

0000 0 000000 000000 

0001 0 000370 0A0001 

0002 0 000000 000000 

0003 0 000000 0003E8 

0004 0 000000 050B88 

0005 0 000000 000000 



LINK AG 

INFO .,„,,,« .... „„„~v.«, , 
SIZE (TOTAL SIZE*9. MEMORY 

(MSGCOUNT-3, 
TANKINFO (R0WSIZE»5 
OBUFFDESC 
QLOCKEVENT 

QINSERTEVENT 

QTIBDESC 
QLOCKCONTEND 
QLOCKOWNER 



LINKAGE (0TAIL»00OO0, OHEAO=00000) 
INFO (ACTIVATING SNR£037. USERS'l) 
SIZE (TOTAL SIZE«0. MEMORY S1ZE*0) 
MSGINFO (MSGCOUNT'd, MEMORYL IM I T>10Q0) 
TANKINFO (R0WSIZE=5, BLOCKS IZEOOOO) 
BUFFDESC 
QLOCKEVENT 

QINSERTEVENT 

QTIBDESC 

QLOCKCONTEND 

QLOCKOWNER 

LINKAGE (OTAIL=00000, OHEAD*00000) 
INFO (ACTIVATING SNRio37. USERS=1) 
SIZE (TOTAL SIZE»0. MEMORY SIZE»0) 
MSGINFO (MSGCOUNT'O, MEMORYLIMIT»l000) 
TANKINFO (R0WSIZE»5, BL0CKSIZE=>3000) 
BUFFOESC 
LOCKEVENT 

QINSERTEVENT 

QTIBDESC 

QLOCKCONTEND 

QLOCKOWNER 



********** 



(OTAIL»00000, QHEAO=00000 
ACTIVATING SNR=037, USERS-1 



LINKAGE 

INFO (..-. ..... ...... ...... 

SIZE (TOTAL SIZE»0. MEMOftY SIZE=Ol 
MSGINFO (MSGCOUNT'd, MEM0RYLIMIT=l000) 
TANKINFO (R0WSIZE=5, BLOCKS IZE»3000) 
BUFFDESC 



Figure 4-24. QUEUE Command Output 
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READYQ 

The READYQ command prints the ready queue in priority order. The ready queue is a 
list of processes that are waiting for a processor. 

— READYQ 1 

RECESS 

The RECESS command allows the user to exit from DUMPANALYZER without 
removing the "pseudorecovery" file created during DUMPANALYZER's initialization 
process. For information on the usage of the pseudorecovery file, refer to 
"DUMPANALYZER Files" in this section. 

<recess> 

— RECESS 1 

RELEASE 

The RELEASE command causes the current output file to be closed and saved. 
<release> 

— RELEASE -, 1 1 

L_ DISKFILE _l 

The following text describes the meaning of each option: 

RELEASE Closes the current printer file. Repeated use of this command 

allows the output from the DUMPANALYZER run to be split into 
several printer files, which print when the originating job or MCS 
session terminates. 

RELEASE DISKFILE Closes and saves the current disk output file. If output was 

previously routed to the disk file, the output mode is changed to 
either the remote terminal or the printer (through an ODT run) by 
default. An immediate DISKFILE "<file title>" command can be 
used to route the subsequent output to the newly assigned disk 
output file. 

If there is a disk output file existing before normal termination of 
the run, DUMPANALYZER automatically closes and saves the 
disk file. 

For more information, see the discussion of the following commands in this section: 

• DISKFILE 

• RELX 

• REPEAT 

• SHOW 
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RELX 

The RELX command causes the current line printer file to be closed and printed while 
DUMPANALYZER is still running. The RELX command differs from the RELEASE 
command in that RELX causes immediate printing. 

<relx> 

_ relx 1 

The printout is preceded by a heading page containing the usercode and mix number of 
the DUMPANALYZER task, and the job name DPAOUTPUT. 



REMOTE 



The REMOTE command routes output to the terminal rather than to a line printer or 
diskfile. REMOTE is not valid when DUMPANALYZER is run from the ODT. 

<remote> 

_ REMOTE 1 



REPEAT 



The REPEAT command causes the previous interactive command to be repeated. The 
output from the command is routed to either the printer or the remote terminal. 

<repeat> 
— REPEAT 



PRINTER - 
DISKFILE 



The following text describes the meaning of each option: 



REPEAT 

REPEAT PRINTER 
REPEAT TO PRINTER 



REPEAT DISKFILE 
REPEAT TO DISKFILE 



The previous command is repeated. Output is repeated to 
whatever peripheral device has been initially specified. 



The previous command is repeated and the output is directed to 
the line printer. If REMOTE operation is in effect, each REPEAT 
to the printer is in a separate printer backup file. This version of 
the REPEAT command can be used to obtain a hard copy of 
command output during an interactive session at a remote 
terminal. 



The previous command is repeated and the output is directed to 
the user-assigned disk output file. See the DISKFILE and 
RELEASE commands for information on assigning and saving the 
disk output file. 
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{ 

For more information, see the discussion of the following commands in this section: 

• DISKFILE 

• RELEASE 

• SHOW 

RESULTQ (EMS Systems) 

The RESULTQ command invokes output of the result queues generated by I/O 
operations. These result queues display the linking together of IOCBs after the I/O 
operations are complete. This command is only valid for dumps from EMS systems. 

<resultq> 

— RESULTQ 1 

Example 

Figure 4-25 shows example output from the RESULTQ command. 
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00 

cn 
o 
o 

o 
•£> 
vi 
oo 



o 
o 



crq 
c 

?S 



c 

§ 

o 
o 

3 

3 

01 
3 
Q- 

o 

c 



INPUT : RESULTQ 
********** 



000 



00000 
00000 



000000 000000 
. C00001 E01C30 
LINKED I0CB 9 



H97E - 
RESULT( 
EMPTY ( 
EMPTY ( 
•MOST Rl 
00028F4F 



jUEUE? 
UEUE 

CENT I0CB FINISHE0) 



IN PROCESS. **** 



**** WARNING: THIS I0CB IS 
**** THE ANALYSIS MAY BE U 
I0P CNTRL: 

0LP A0DRESS: 
UNIT QUEUE: 
SELF PTR: 
COMMANO PTR: 
RESULT PTR: 
C/R LENGTHS: 
RESULT MASK: 
RSLT qUEUE: 
NEXT LINK: 
DATA PTR: 
CURR LENGTH: 
IOP RSLT: 
START TIME: 
FINISH TIME : 
INF01 WORD: 
INF02 WORD: 
LOG DESC: 
IOCW: 
BUFFER DESC: 
EVENT REF: 
FIB DESC: 
10 MASK: 
LOGICAL RD: 
10 INFO: 
CMO/RSLT: 
CMO/RSLT: 
CMD/RSLT: 
CMO/RSLT: 
SAVED INFO: 
LINKED IOCB 9 0008D7A5 

**** WARNING: THIS IOCB IS IN PROCESS. **** 
**** THE ANALYSIS MAY BE INCONSISTENT. **** 

IOP CNTRL : 0 10CB00 028409 TEST 



o 


10CB00 


026409 


0 


000001 


100010 


5 


C00001 


6019A0 


5 


C00001 


E01C30 


5 


E00001 


901C30 


5 


E00001 


B01C30 


0 


000000 


OAOOOC 


0 


000000 


000000 


5 


EOOOOO 


30197E 


5 


C00001 


E026CF 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000025 


0 


000553 


D64966 


0 


00058C 


5759D1 


0 


01202D 


78000C 


0 


000813 


C91302 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


216000 


000000 


0 


000000 


000000 


0 


004100 


000000 


0 


000000 


000000 


0 


000000 


000000 



TE 5 T ,A,.£ HA ?'„E°5 WARD ' PROTECT, IMMEDIATE, DON'T COUNT, CAUSE 10 FINISH, 

QUEUE AT HEAO 
IOP 10=1 , IOP PORT=0, LEM P0RT*1, REL DLP»0 



EXCEPTION DLP ERROR. COMPLETED AFTER Q SUSPENOEO 
15:15:15 (00:37:49.82936 PRIOR TO DUMP J 
15:53:10 (00:00:05.32850 AFTER DUMP) 

UNITNUMBER » 50, OWNER STKNO » 012. INITIATING STKNO « 
STATE = 3 (ACTIVE). FIXEO PATH, PATHNAME * 01, PROC NO 

IOSTANDARDFIELD: WRITE, 6-BIT 



02D. 
■ 9, 



30 (KERNEL 10 ) 
NO » 1, IOTYPE » 2, FATE 



REQUESTOR 
IOP 



DLP ADORESS: 
UNIT QUEUE: 
SELF PTR: 
COMMAND PTR : 
RESULT PTR: 
C/R LENGTHS: 
RESULT MASK: 
RSLT QUEUE: 
NEXT LINK: 
OATA PTR: 
CURR LENGTH: 
IOP RSLT: 
START TIME: 
FINISH TIME: 
INF01 WORD: 
INF02 WORD: 
LOG OESC: 



10 



0 000001 100010 
5 C00001 60199F 
5 COOOOl E026CF 
5 EOOgOl 9026CF 
5 E 00001 B026CF 
0 000000 OAOOOC 
0 000000 000000 
5 EOOOOO 30197E 
5 COOOOl E01C2E 
0 000000 000000 

o gooooo oooooo 

0 OOOOOO 000025 
0 000563 A3A51E 
0 00058C 574505 
0 012014 78000B . 
0 000813 C91302 STATE 
0 OOOOOO OOOOOO 



QUEUE" AT* HEAO WARD ' PR0TECT * IMMEDIATE . D0N ' T COUNT, CAUSE 10 FINISH, 
P ID»1, " " 



IOP PORT«0. LEM PORT-1, REL DLP«0 



EXCEPTION, DLP 



ERROR, COMPLETED AFTER Q 



SUSPENDED 



15:25:51 00:27:13.54952 PRIOR TO DUMP ] 
15:53:10 (00:00:05.31622 AFTER OUMP) 

UNITNUMBER - 49. OWNER STKIIO- 012. INITIATING STKNO » 014, REQUESTOR • 30 (KERNELIO) 

(ACTIVE), FIXEO PATH, PATHNAME » 01, PROC NO - 9, IOP NO » 1, IOTYPE - 2, FATE 
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RJ 

Note The RJ command has been deimplemented. The RIGHTJUSTIFY 
option of the TERMINAL command can be used instead. 

SAVE 

The SAVE command saves the contents of memory dump tapes and relevant 
information from the MCP code file in a disk file for later analysis. The file is saved 
under the <file title > given; <file title > must appear in quotes. LINEINFO must be 
set and the MCP global names must be available. The AREASIZE of the saved file is 10 
records or 500 segments. 

When the TAPEIN file has been file-equated to a DP file and the saved dump file 
is to reside on the same pack family, the DP file is updated with the MCP code file 
information and the title of the DP file is changed to the <file title> given. The original 
DP file will no longer exist if the SAVE command completes successfully. This occurs 
only if the DP file that is file-equated to TAPEIN has your usercode; otherwise, a new 
saved dump file with the title <file title> is created. 

The file created by the SAVE command can be quite large (from 30,000 to 150,000 disk 
segments). It might be desirable to copy the file to tape rather than leaving it on disk 
for this reason. 

The file created using the SAVE command is not removed when DUMPANALYZER is ( 
exited. It must be removed using CANDE commands or MARC screen functions. 

<save> 

— SAVE — " — <file title>— " 1 

SEARCH 

The SEARCH command, when used in conjunction with the MASK and PATTERN 
commands, provides the ability to check each word in a memory dump for a specified 
pattern of bits; this pattern can include all 48 bits within the word and its four tag 
bits, or it might search for all words that have a subset of those 48 bits in common. 
SEARCH can cause a search for a pattern that is specified by the PATTERN command 
and limited by the mask set in the MASK command. Patterns for a search can also 
be specified within the SEARCH command; these patterns do not use the mask and 
pattern registers. 

The addresses of the words that match the specified pattern, along with the contents 
of those words, can be saved and later retrieved as desired. The saved words can be 
searched again with different search patterns. 
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<search> 



SEARCH 



ABSENTCOPY 
h ABSENTDESC 
MEMERRORS - 
- MOMDESC — 
L PREVIOUS — 



— /1\- REFS — <simple address> 

-/1\- RANGE — <multiple addresses: 

MASK — <simple va!ue> 

-/1\- PATTERN — <simple value> 



— ?AX 



WHERE 

h- STOP 

TEXT 

+ — TEXT 

KEEP 

L- SKIP 



The following text describes the meaning of each construct: 
SEARCH 



ABSENTCOPY 
ABSENTDESC 
MEMERRORS 

MOMDESC 
PREVIOUS 

REFS <simple address> 



RANGE <multiple 
addresses> 



MASK <simple value> 



If SEARCH is used without any modifying tokens, the contents of 
the pattern and mask registers are used in the search. Refer to 
the MASK and PATTERN commands for information about how 
these registers are set. 

ABSENTCOPY causes a search for all absent copy descriptors. 
An absent copy descriptor references a data structure on disk. 

ABSENTDESC causes a search for all absent mom descriptors. 
An absent mom descriptor references a data structure on disk. 

MEMERRORS causes a search for regions of memory that 
contain memory parity errors. The MASK and PATTERN options 
are ignored when MEMERRORS is used; however, the other 
SEARCH options are unaffected. 

MOMDESC causes a search for all present mom descriptors. A 
present mom descriptor references a data structure in core. 

PREVIOUS causes a search from among a group selected from a 
previous SEARCH command and stored via the K option 
described below. 

REFS causes a search for present descriptors that reference the 
section of memory including the specified address. 

RANGE <multiple addresses> indicates a range of memory over 
which to search. <multiple addresses> indicates which set or 
sets of addresses constitute the range. The syntax for < multiple 
addresses> is provided in "Basic Constructs" in this section. 

MASK <simple value> can be used to specify a mask to be 
used for the duration of the search only, but not to be placed in 
the mask register. The contents of the mask is <simple value>, 
a hexadecimal representation of a 48-bit word with an optional 
tag, which places a 1 in each bit that is significant in the 
pattern, and a 0 to mask all insignificant bits. 



continued 
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continued 



PATTERN <simple 
value> 



?AX 



?AX WHERE 
?AX STOP 

?AX -TEXT 
?AX +TEXT 

?AX -KEEP 
?AX SKIP 



PATTERN can be used to specify a pattern for which to search; 
however, this pattern will not be placed in the pattern register. 
The contents of the pattern is <simple value>, a hexadecimal 
representation of a 48-bit word with an optional tag, whose 
significant bits are pointed to by the mask. The SEARCH 
command takes this pattern and finds words which match the 
pattern in the significant bits which have been selected by the 
mask. 

:T lists the words that match the current pattern modified by the 
current mask and the hexadecimal address for each word next to 
its contents. 

:K retains a list of all words that match the current pattern 
modified by the current mask, and the addresses for those 
words. This list can be SEARCHed again later using the 
PREVIOUS modifier. All of memory is searched unless RANGE or 
PREVIOUS is used. 

The search can be controlled asynchronously through the ?AX 
(Accept) option. The search occurs from the high end of memory 
toward 0; thus, memory indices printed in response to ?AX 
WHERE decrease. The different combinations of tokens for the 
?AX command follow. 

The WHERE option asks where the search is. 

The STOP option stops the search and reprompts the user with a 
": READY" message. 



The +TEXT and -TEXT options turn the listing of the text on and 
off, respectively. 

The -KEEP option suppresses the formation of the list of kept 
matches. 

The SKIP option abandons the current range and skips to the 
next range (if any). 



Examples 

The following command searches stack 368 for all words that match the criteria 
previously set by the MASK and PATTERN commands: 

SEARCH RANGE STK 368 BOSR TO LOSR 

The following command finds all mom descriptors in memory and retains them in a list: 

SEARCH MOMDESC RANGE 0 TO END :K 

The following command searches the list of mom descriptors stored by the previous 
command, and finds those that refer to the region including address 381F6: 

SEARCH REFS 381F6 PREV : T 



4-114 



8600 0478-100 



DUMPANALYZER 



SHOW 



For more information, see the discussion of the following commands in this section: 

• MASK 

• PATTERN 



The SHOW command shows the previous input. 



— SHOW 



— T^I3 



SIB 



STACK 



The following text describes the meaning of each option: 
SHOW 



SHOW ALL 



In addition to the previous input, the output mode (remote, 
printer, or the name of the disk output file) is also displayed. 



For more information, see the discussion of the following commands in this section: 

• DISKFILE 

• REPEAT 

• RELEASE 



Note: Previously, structure information blocks (SIBs) were treated as 

stacks. SIBs are now treated like any other array. Therefore, the SIB 
command is no longer needed and has been deimplemented. 



The STACK command displays the formatted and interpreted contents of a stack. 
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<stack> 
— STACK 



:first parameter? — <second parameter>- 



<first parameter> 



ACTIVE 



- ALL 

- DATABASE 

- DUMPING - 



<number> 



<second parameter> 



HISTORY 
SUMMARY 



L OFFSET — <simple value>- 



u 



ssimple values 



L- PIB - 



The first parameter of the STACK command is used to specify the stack or set of stacks 
to be displayed. The following text describes the elements of the first parameter: 



ACTIVE 
ALL 

DATABASE 
DUMPING 
<number> 



All stacks that are alive or active at the time of the 
dump, including the stack that is performing the 
dump, are displayed. 

All stacks on the system are displayed. 

All task stacks using Data Management System II 
(DMSII), including database stacks, and database task 
stacks are displayed. 

The stack performing the dump is displayed. If a 
different stack initiated the dump, then the initiating 
stack is also displayed. 

All the specified stacks are displayed. 



The second parameter of the STACK command is used to restrict the display of the 
stack or stacks. If no restriction is present, the entire stack and its PIB are displayed. 
The following text describes the elements of the second parameter: 



HISTORY 



SUMMARY 



OFFSET <simple value> 



OFFSET <simple value> 
<simple value> 



The MSCWs and RCWs in the stack or stacks are 
displayed. In HARDWAREINTERRUPT environments, 
the PI and P2 parameters are also shown and 
analyzed. 

The summary information for the stack or stacks is 
displayed. 

The contents of the stack or stacks starting at the 
offset <simple value> and continuing to the base of 
the stack are displayed. 

The contents of the stack or stacks between the two 
specified offsets are displayed. Note that the first 
<simple value> must be greater than the second 
<simple value>. 



PIB 



The PIB of the stack is displayed. 
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Example 1 

The following example lists stack 368 from 10B to F5. 
STACK 368 OFFSET 10B - F5 

Examples 2 through 4 

A complete example of the STACK command output is presented in three parts in 
Figures 4-26, 4^27, and 4-28. 



Process Stack (Figure 4-26) 

The first part of the STACK command output, shown in Figure 4-26, includes the 
following items: 



Item 

STACKDUMP FOR STACK 
<number> 

MIX NUMBER 
NAME 

JOB MESSAGES 
STACK KIND 

STATUS 
PROCESS TYPE 



BOSR 
LOSR 

LENGTH 



Meaning 

Specifies the stack number. 

Lists the job number and mix number for the process. 

Lists the name of the process, in this case 
ONESECONDBURDEN. 

Lists RSVP, DISPLAY, or ACCEPT messages for the process. 

Lists the type of process, in this case "I.R." for "independent 
runner." 

Lists the current status of the process. 

Lists the process type as recorded by the TYPE task attribute: 
CALL (synchronous task), PROCESS (asynchronous task), RUN 
(job written in a language other than WFL), or JOBSTACK (WFL 
job). 

The absolute memory address of the base of the stack area. 

The absolute memory address of the upper limit of the stack 
area. 

The length of the stack area in hexadecimal and decimal 
notation. 



Following these items is a listing of the contents of each word in the process stack, 
starting with the S register and working down, one word per line. Each entry is divided 
into the following columns, from left to right: 

• A 4-digit hexadecimal number giving the offset of the word from the base of the 
stack. 

• Address couples (such as 01, 000C) giving the lexical level and offset of items 
declared in each procedure. 
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• The contents of the word, expressed in hexadecimal. The leading digit expresses 
the tag bits. The remaining 48 bits are represented by two groups of 6 hexadecimal 
digits. Each hexadecimal digit represents a group of four bits, starting with [47:4] 
and working over to [3:4]. 

• Analysis of the contents of the word. 

The following are some features of the analyses presented for various types of words: 

• Operands are printed in octal, decimal, and EBCDIC according to the following 
rules: 

- Decimal operand values can be formatted in integer, fixed-point, or exponential 
notation, as appropriate. 

- EBCDIC operands are printed in EBCDIC only if all characters are graphics. 
However, if an operand contains right-justified EBCDIC characters with null 
fill, the EBCDIC characters are printed. 

- The MODE command, discussed elsewhere in this section, specifies modes 
controlling the expansion of various types of words. 

• DESC (word data descriptor) analyses indicate whether data is present in, or absent 
from, main memory, whether the descriptor is a copy or the original descriptor, the 
type and length of the data item, and (if required) the address of the data item. 

• DROP (double-precision operand) analyses indicate the value of each word in octal, 
scientific notation, and double-precision scientific notation. 

• MSCW (mark stack control word) analyses are preceded by an asterisk (*) to make 
them easy to spot, and include a reference to the position of the previous MSCW 

• PCW (program control word) analyses include the lexical level of the procedure 
being entered, the segment number and relative address within that segment 
where procedure entry occurs, and the interrupt state. 

• RCW (return control word) analysis includes the lexical level, state (control 
state or normal state), segment number, relative address within the segment 
where procedure entry occurred, and the sequence number of the record where 
the procedure is located in the source file. The RCW analysis is followed by the 
following entries: 

- SEG DESC (segment descriptor) analysis, which includes the name of the 
procedure referenced by the row. 

- CODE analysis, which includes right and left broken brackets {"> <) around 
the word where procedure entry occurred. 

• SCW (software control word) analyses specify the type or dimension of arrays, the 
type of declaration (file, interrupt, or fault), or the presence of a nonlocal GO TO. 

• SIRW (stuffed indirect reference word) analyses indicate the offset into the 
specified process stack. 

• SIW (step index word) analyses indicate the current value, increment value, and 
final value of an iteration statement. 
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Process Information Block (Figure 4-27) 

The second part of the STACK command output, shown in Figure 4-27, starts with 
a pointer to the SPIBVECTOR, which is parallel to the stack vector and stores 
descriptors for active process information blocks (PIBs). Then, for each word in the 
PIB, there is an entry separated into the following columns, from left to right: 

• The hexadecimal offset of the word in the PIB. 

• The hexadecimal contents of the word. 

• Analysis of the contents of the word. 

Task Attribute Block (Figure 4-28) 

The third part of the STACK command output, shown in Figure 4-28, shows the 
contents of the task attribute block (TAB) for the process. The format of this output 
is similar to that used for the PIB printout. Note that arrows (= >) appear in front 
of active task attributes. Following the TAB listing is a dump of the contents of the 
environment TAB for the process. 
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I 



ro 
o 



-n 

to' 
c 

CD 



O 

o 
o 

3 

3 
u 



o 

o 

CD 

if> 
V) 

CO 

CD 
o 



00 

o 
o 
o 

-•J 

00 



INPUT: STACK 34 



STACKOUMP FOR STACK 034 



MIX NUMBER 0/0 



NAME : 0NESEC0N0BURDEN. 



JOB MESSAGES: (NULL 

LOCK STATUS: (NONE FOUND) 

STACK KINO: l.R. 

STATUS: REAOY 

^PROCESS TYPE: RUN 



o 
c 

5 



m 
73 



STACKINFO = 0 000803 580000 
STACKSTATUS = 0 1E640F 000010 
NORMAL 



B0SR=0002204B 
0026 



L0SR=0002210D LENGTH=00192 (402) 



0025 
0024 
0023 
0022 



0021 

0020 
001F 
001E 
00 ID 
001C 
001B 
001A 
0019 
0018 
0017 
0016 
0015 



0014 

0013 
0012 

0011 
0010 
000F 
000E 
0000 
000C 
000B 
000A 
0009 
0008 
0007 
0006 
0005 
0004 
0003 
0002 
0001 
0000 



01,0004 
01,0003 
01,0002 



"Dtl] 

,000C 
,0006 
.000A 
,0009 
,0008 
.0007 
,0006 
,0005 
,0004 
,0003 
,0002 



Dtl] 
0[2] 



3 


0001)41 


285021 


0 


000000 


065B9B 


0 


000000 


000002 


0 


000000 


000000 


3 


01003C 


085021 


«>3 


012000 


84400D 


6 


A00000 


000000 


0 


000H08 


185021 


7 


000007 


189021 


4 


025FF3 


E23000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


00AF9E 


0 


000000 


000006 


0 


000364 


0C4825 


0 


000000 


00AEE1 


0 


000005 


055017 


3 


000I!8F 


E890E4 


= >3 


012000 


844002 


-A 


000000 


002000 




000327 


3C8011 


5 


270001 


241117 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


000000 


0 


000000 


004608 


0 


000000 


000000 


5 


000000 


400000 


0 


000000 


000000 


0 


000000 


000000 


? 


000000 


000000 




034000 


000000 


0 


000000 


000000 


6 


800000 


000000 


0 


000CI00 


000000 


0 


000000 


000000 


3 


034000 


040000 


3 


000002 


600005 



RCW: 11" 1, CNTRL STATE 

SEG DESC: 3 A0016E 301100 BLAST WAITING STACK 

CODE: 3 OO07B2 158CA0 3 241101 04A24* 3 11B09C 2704B0 



[MCP SEGMENT 
UTII 



RCW: LL»1, CNTRL STATE 
SEG OESC: 3 A0016E 301100 
CODE: 3 C5E3C9 D4C500 3 
*MSCW: 



£MCP SEGMENT 

REAOYQINSERT 

. 9542AB ABAE40 3 B5B0B2 02B1AB 

PREVIOUS MSCW 9 0014; D[0]=0008 IN STACK 012 u ' Dino 



9 1021:0412:3 (01064800/13504615/135 
>3 B6959E 6002B8< 3 B23595 B84326 

9 1021:03C0:0 (04280770/13504251/135 
>3 B5A200 8CB5B5< 3 A3FFFF FFFFFF 



SCW: (NO-GOPAST) 
PCW 

"ON <FAULT>" MARKER 



RCW: LL=2 . CNTRL STATE [MCP SEGMENT 

SEG DESC: 3 A00146 603277 SCHEOULER 

COOE : 3 4A6870 C30C30 3 B0B096 2BABA3 3 FFAE40 7BABA3 
*MSCW: PREVIOUS MSCW 9 0012; D[0]=0008 IN STACK 012 

RCW: OUMMY (RUN) 

*MSCW: PREVIOUS MSCW 9 0001; 

THEFILE 

STR INGPOOLMOM 

STR INGPOOLMARK 

LOCKCOUNT 

JUNK 

BL0W8Y 

WARNINGLIST 

SEGMNTARRAY 

CONDLISTDESC 

OATDESC 

AITOESC 

STACKINFOTOP 

OLAYINFODESC 

OLAYCW 

INTMAPLINKS 

BASEOFSTACKRCW 

BASEOFSTACKMSCW 

TOSCWD 



9 10E4:08FE:1 (17458000)] 
>3 FFB234 B22695< 3 B8B180 95B9A2 



O 



SPIBVECT0R[034] » 5 800005 B03273 



•15 



00 
01 
02 
03 
04 
05 
06 
07 

08-OC 
00-11 
12 
13 
14 
16 
17 
18 

19- 10 
IE 

1F-20 
21 
22 
23 

24-26 
27 

28-28 
2C 

20- 31 
32-36 
37-39 
3A 

3B 

3C-40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

4A 

4B-4C 
40 

4E-52 

53 

54 

55 

56 

57-58 
59 



012000 
000000 
000000 
000000 
400000 
000000 
000000 
000000 
000000 
000000 
000079 
000327 
000000 
000340 
000000 
800000 
000000 
4E3845 
000000 
012000 
000000 
C32000 
000000 
000000 
000000 
034000 
000000 
000000 
000000 
800003 
000000 
000000 
000000 
273100 
000327 
2730F8 
000327 
000000 
000000 
000000 
000000 
400000 
000000 
400000 
000000 
007FFF 
007FFF 
000000 
C32000 
000000 
800004 



844000 
000000 
000012 
000000 
004E18 
0001DC 
0001DC 
00010C 
000000 
000000 
E8900B 
3C0012 
000000 
000000 
000000 
000000 
000000 
79708C 
000000 
84026C 
000000 
000040 
000000 
000063 
000000 
000000 
000000 
000000 
000000 
A03276 
000002 
000000 
000000 
189021 
3C0042 
889021 
3C0044 
002000 
000000 
000005 
000000 
564C7A 
000000 
000455 
000000 
FFFFFF 
FFFFFF 
000000 
000041 
000000 
F03274 



PIBMSCW 

COOEHEAOERS 

CODEUNKS 

COMPILERINFO 

COREINTEGRAL 

COREINUSE 

COREINUSESAVED 

MAXSAVEMEMORYUSEO 

ASOSINUSE 

OLAYSACTIVE 

WS PALACE 

WS-PALACEREF 

DBSINFO 

BOINFO 

EVENTCAR 

BEOWORD 

EVENTCOUNT 

B0TT1MESTAMP 

CP1NF0 

ENTRYPOINT 

RESTARTRCW 

EXCEPTIONEVENT , 

(EXCEPT I0NEVENT2 ) 

HEADERACCESS 

INSTRETRY INFO 

JOBINFO 

JOBMSGS 

REMPR INTMASK 

ROLIOUTINFO 

P1BI0CB 

TASKTYPE 

WAITSTART 

RECENTPROC 

PALACE 

PALACEREF 

HOVEL 

HOVELREF 

USAGE 

DMSBED 

READYON 

PROCESSOR 

CL0CK0NT1ME 

LETGEORGEOOIT 

PROCESSTIHE 

I0T1ME 

MAXPROCESSTIME 
MAXI0T1ME 
MISCINFO 
PIBEVENT , 
(PIBEVENT2) 
TASKING TAB 



SEG 01CT = 012 

. -19992 
= 476 
= 476 
= 476 

HAXASOSINUSE 
SEARCHI NFO 

PCW: LL=2, orol SEGMENT (? 1Q 
SIRW: OFFS£T=OOI2 (0000+0012) 
YOURNAME 



MAXSTACKCHECK 
SUBSPACEiD 
SEGMENT P 100B: 



GRAPHHEADWORD 
D1T IMESTARTED 
079E:0, CNTRL STATE 



SEGMENT = 03273 



OLAYCNTL 
, RUNNl NGCOUNT 
(05374780) WS JUDGE JACKET 



BLOCK 



=01/24/90 12:25:59 
0CKEYP1BINFO 



ALARMT1MES 



ASSUMEI0T1ME ASSUMEPROCESSTIME 

SlRW: 0FFSET=0274 (0008+026C) STACK = 012 (PCW) REA0YQ1NSERT 

EVENT 00040 NOT HAPPENED 
EXTERNALFAMILYLIN FREEPBITS 



I NTERCEPTEDRCW . INTERCESSION 

LIBRARYSTATUS P IBL0CKS4 7 
REMPUNCHMASK REPLY 
SOFTINTQ TASKINFO 

0RCP1BINF0 PRTABLE 

??Sw: ^ L Fl E T?to°J2 S fo G S§8Io§4lf ^ G S?Nt°= S!J5i STATE < 14650720 > WOATESTACKPROCS 
5f&: tititMS ffiIo§ 4 lnE°GM?5t 0 = gSJi STATE <" 650720 > UPOATESTACKPROCS 
= NOT I NHER I TMCS STATUS 



JOBDECK INFO 



P0RTL1B P1B 
REPLYEVENTX 



ACTIONBITS 



PROCESSFAMILYLINK 
(REPLYEVENT2) 



ACT IONQHEAO 



0 0:00.00 AFTER HALTLOAO 



202.308679 SECONDS PRIOR TO DUMP 
188.735074 SECONDS PRIOR TO DUMP 



9 0:00:13 AFTER HALTLOAD 
READYTIME 
= -0.0026616 SECONOS 

=°549755813887 O^SPRINGACCOUNTS FILEACCOUNTS 
= 549755813887 

EVENT 00041 NOT HAPPENED 
ML INFO 



VAL IDITYB ITS 





_ _ 


TAB 






00 


-02 


0 


400000 


564DFA 


T f MPCTAOTCn 
1 inc i 1 tsn 1 tu 


01 


0 


000000 


OOOOOO 


nt^KTMTPFRM 


03 




0 


000000 


000003 


INfTPRf TKnilMT 

ill l r O I IKUUIII 


04 




0 


000000 


000455 

WWW "t *J J 


INYTPft! TTYMF 


05 


-09 


0 


000000 


nnnonn 


I nrniiNT i 


OA 


-OE 


0 


000000 


nnnnnn 

UVwww w 


HTHPRPR t TmilMT 


OF 


-13 


0 


oooooo 


OOOOOO 

Vw WWW 




14 


-18 


u 


fin nnnn 


oooooo 




19 


-10 


0 


oooooo 


oooooo 


CHARGEC0DE 




-21 


n 
U 


UU JUUU 


oooooo 


JSTITLE 


! 


-27 


5 


800000 


403275 


MYNAME 


23 


0 


oooooo 


oooooo 


MYPPB 


28 


-28 


0 


oooooo 


oooooo 


TASKMCSNAME 


2C 




0 


oooooo 


104000 


VALIOITVBITSTAB 


2D 


-31 


0 


oooooo 


oooooo 


AVALUE 


32 


-35 


0 


oooooo 


oooooo 


EXCEPTIONTASK 


36 




0 


000028 


000004 


MISCTABINFO 


37 


-3A 


0 


oooooo 


oooooo 


OPTION 


3B 




0 


oooooo 


000066 


->PRI0R ITY 


3C 


-3D 


0 


oooooo 


oooooo 


PUNCHLIMIT 


3E 




0 


007FFF 


FFFFFF 


SAVEMEMORYLIMIT 


3F 




0 


034000 


oooooo 


SERIAL 


40 




0 


OOOOOO 


001770 


STACKLIMIT 


41 




0 


OOOOOO 


00017C 


«>STACKSIZE 


42 


-46 


0 


OOOOOO 


oooooo 


STATIONINFO 


47 


-48 


0 


oooooo 


oooooo 


f ASKERROR , 


4C 


-4E 


0 


oooooo 


oooooo 


(USERC0DE3) 


5A 




5 


C0C004 


F03274 


ENVIRONMENT TAB 


STACK 


.034 TCP DATA: 000000 005014 000000 



9 0:00:13 AFTER HALTLOAD 
OISKINTTEMP 



188.734152 SECONDS PRIOR TO DUMP 



0.0026616 SECONDS 



I0C0UNT2 
OTHERPB ITTIME 
HSINFO 

TEMPF ILEMBYTES 

DBEQTNBLK 

MYBONAME 

= ONESECONDBURDEN 
MYPR I NTDEFAULTS 
TASKSTR ING 

CODECORE 
MAX IOTIMETAB 

PARTNER 
= 102 

RESTARTCOUNT 
= 549755813887 

= 6000 
=0*380=380 
SWAPSPEX 
TASKL IM IT 
USERCODEPRIV 



HISTORY 
PROCESSTIME 
ITINERARY 
WFLJOBINFO 
DESTNAME 
MYFPB 

SUPPRESSWARNING 
LOCKEDEVENT 



IOTIMETAB 
STOPPOINT 
L INESPR INTED 
ACCESSCODE 
FAMIL YSUB 
MYLPB 

SOURCENAME 
(L0CKEDEVENT2) 



DATACORE DISKLIMIT 
MAXPROCESST IMETAB MAXWAIT 



MYSTACKHISTORY 
CARDSPUNCHED 
SURROGATE INFO 
BACKUPFAMILY 
HOSTNAME 



SUBSYSTEMID 



ELAPSEOLIMIT 



PATHCONTROL 



TAPECOUNT 

TEMPFILEL1MIT 

WAITLIMIT 



PRINTLIMIT 



TAPEPOOL 
USERCODE 



TARGETTIME. 
(USERC0DE2) 



ANALYSIS: STATE = NOT BLOCKED. REAOY. RETURN 

ORIG. BASE PRI = 3866, BASE PRI = 3866, 
PROCESS STATISTICS: 



OOOOOO OE1995 OOOOOO 0E1981 
FINE PRI = 01. CLASS = 5 



00 

01 

02 

03 
04 

05 
06 
07 
03 
09 
OA 
OB 
OC 
01) 
OIE 
Ol- 
ll) 

IS 

11 



IF 



OOOOOO OOOOOO 

410000 01413F 

530000 47761A 

OOOOOO OOOOBF 
OOOOOO OOOOOO 
000015 2BDB3A 
OOOOOO OOOOOO 
OOOOOO OOOOOO 
OOOOOO 000001 

oooooo oooooo 
oooooo oooooo 
oooooo oooooo 

920A95 E740OO 
920A95 E74143 
920A95 E09000 
OOOOOO OOOOOO 
OOOOOO OOOOOO 

OOOOOO oooooo 
oooooo oooooo 
oooooo oooooo 
oooooo oooooo 



MAXPROCESST IME 
TOTAL MAXPROCESSTIME 
PROCESSTIME 
TOTAL PROCESSTIME 
REAOYTIME 
TOTAL REAOYTIME 
PROCESSOR VISITS 



549755813887 
0.1973736 SECONDS 
0.194712 SECONDS 
11.239896 SECONDS 
11.239896 SECONDS 



EXPIRATION TIME 9 0:03:23 AFTER HALTLOAD = -0.8542248 SECONDS PRIOR TO DUMP 



RETURN PARAMETER 
RETURN PARAMETER 
P2 PARAMETER 



LAST ALIVE 
LAST WAITING 
LAST READY 



HEAD OF OWNEO 
EVENT WAITING 



0:03:22 AFTER HALTLOAD = 
0:03:22 AFTER HALTLOAD = 
0:03:23 AFTER HALTLOAD = 



EVENTS QUEUE 
TO PROCUREOOOOO 



1466328 SECONDS PRIOR TO DUMP. 
1458576 SECONDS PRIOR TO DUMP 



-0.8542248 SECONDS PRIOR TO DUMP 
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STACKWINDOW 



The STACKWINDOW command displays selected areas of a stack within a memory 
dump. The display contains approximately 22 lines of data. In particular, the user's 
view of the specified stack centers on a particular stack cell. It is suggested that the 
HISTORY option of the STACK command be used before using the STACKWINDOW 
command. That option provides a view of the locations of the environments within the 
stack. 



Use the STACKWINDOW command when it is not convenient to print the whole stack 
on paper. 

<stackwindow> 
— STACKWINDOW 



-<stack number 



-<offset: 



<# cells>- 



The following text describes the meaning of each construct: 



STACKWINDOW 



STACKWINDOW <stack 
number> 

STACKWINDOW <stack 
number> # <offset> 



STACKWINDOW # 
< offset > 

STACKWINDOW + 
STACKWINDOW- 



STACKWINDOW + 
<# cells> 

STACKWINDOW - 
<# cells> 

STACKWINDOW? 



This form of the command reopens a window created by a 
STACKWINDOW <stack number> form of the command 
entered. 



These forms of the command create a window to view the 
specified stack. If no offset is specified, the view is from the top 
of the stack. If an offset is specified, the view of the stack 
centers on that point in the stack. Once a stack window is 
created, the window is kept unless changed by another 
STACKWINDOW command. All stack structures are limited to a 
maximum of five lines of display, and arrays are limited to one 
line of data values. If the user needs to view more of a particular 
stack structure, the PV SW or PV SW # <offset> form of the PV 
command should be used to expand the information displayed. 

This form of the command allows the user to center the window 
on the specified point in the current stack. 



These forms of the command scroll the window up (■+.) or down 
(-) the stack by approximately one screen. 



These forms of the command scroll the window up (+) or down 
(-) by a specified number of cells. 

This form of the command displays the stack number and offset 
of the current window. 



For more information, see the discussion of the STACK and PV commands in this 
section. 
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Example 

Figure 4-29 shows an example of the output from the STACKWINDOW command. 



r ^ 

STACKWINDOW 031 #02A8 

STACKDUMP FOR STACK 031 MIX NUMBER 5487/5487 WINDOW & 002A8 

02AD 3 2104B2 50E003 RCW: LL=3, NORML STATE 

[USER SEGMENT @ 0003:0B25:2 (23661000)] 

SE6 DESC: 3 800149 E0801B 
CODE: 3 B95032 B8B050 3 CDB8AE 516250 3 
08AF30 027003 >3 BDAB70 04B870< 3 03BDB2 06D5BE 

02AC D[3]=>3 031001 44C005 *MSCW: PREVIOUS MSCW P 02A7; D[2]=0014 IN THIS 

STACK 

02AB (03,0004) 0 000000 000000 

02AA (03,0003) 5 E40000 00C550 DESC [PRESENT-COPY]: ASD=0C550, STRING 
(8-BIT) , INDEX=0+0 (MOM @ 0092 IN THIS STACK) 
02A9 (03,0002) 0 000000 000050 

02A8 3 2 104 IB D0E003 RCW: LL=3, NORML STATE 

[USER SEGMENT @ 0003:01BD:2 (12642500)] 

SEG DESC: 3 800149 E0801B 
CODE: 3 507EA6 B2049C 3 2A0350 72BAAE 3 
5160B2 505072 >3 BDAB50 C6B99A< 3 0901A0 01C1AE 

02A7 D[3]=>3 031001 44C002 *MSCW: PREVIOUS MSCW @ 02A5; D[2]=0014 IN THIS 

STACK 

02A6 3 21088F 30E003 RCW: LL=3, NORML STATE 

[USER SEGMENT G> 0003:08F3:4 (22696800)] 

SEG DESC: 3 800149 E0801B 



V ; J 

Figure 4-29. STACKWINDOW 



STOP 

The STOP command terminates DUMPANALYZER. A synonym for STOP is BYE. 
<stop> 

_ STOP 1 

SUBPORT 

The SUBPORT command prints analysis of a specified subport. Groups of subports are 
associated with different port files. Each subport of a port file can be connected to a 
different process. There are two syntaxes for this command; one for BNA Version 1 and 
one for BNA Version 2. 

One method of locating subport structures for use in the SUBPORT command involves 
using the SEARCH command. The PATTERN command should first be used to 
establish a pattern of E2E4C2D70000 & 0 TAG, and the MASK command should be 
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used to establish a mask of FFFFFFFFOOOO & F TAG. If the SEARCH command is 
then used, the search yields a list of absolute memory addresses of subport structures. 
These addresses can be used in the SUBPORT AT < address > command, as described 
in the following paragraphs. 



BNA Version 1 Syntax 

— SUBPORT -r-<index> 



AT — 
VTA - 



<address>- 



VIA — <ASD number; 



The following text describes the meaning of each construct: 

SUBPORT <index> The <index> value is an index into the PSS array, which is a 

two dimensional, global data structure maintained by the Lists 
Module of the MCP. The user can determine the location of the 
PSS array by using the command MD G PSS. 

The SUBPORT <index> command actually selects PSS 
[<index>,*]. The PSS array contains many different structures, 
only some of which are subports. DUMPANALYZER verifies that 
the <index> points to a valid SUBPORT structure by checking 
word 0, field [47:32] of the element selected (PSS 
[<index>,0].[47:32]). If this field contains "SUBP" and field 
[15:16] of the same word is equal to <index>, then the 
element selected is a valid SUBPORT and is analyzed. If not, an 
"INVALID SABNO" message is displayed. 

SUBPORT AT <address> The subport at the given absolute memory address is analyzed. 

If the memory address specified does not contain a subport 
structure, then DUMPANALYZER displays the message "INVALID 
SABNO". 

The subport at the address referenced by the supplied ASD 
number is analyzed. If the address referenced by the supplied 
ASD number does not contain a subport data structure, then 
DUMPANALYZER displays the message "INVALID SABNO". 



SUBPORT VIA <ASD 
number> 



BNA Version 2 Syntax 

— SUBPORT -r-<index> 



L OF -I L_ port J 

- AT — <address> 

L- VIA — <ASD number> 



-<port index>- 



The following text describes the meaning of each construct: 

SUBPORT <index> <port 
index > 

SUBPORT <index> OF <port 
index > 

SUBPORT <index> PORT 
<port index > 



continued 
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continued 



SUBPORT <index> OF PORT 
<port index > 



SUBPORT AT <address> 
SUBPORT VIA <ASD number> 



The subport with the given index within the port having 
the given port index is analyzed. The port index is found 
in the library information word of the file information 
block (FIB). The subport index specifies the index of the 
subport within the port. 

The subport at the given address is analyzed. 

An address is analyzed using the <ASD number>. 



Example 

The following is an example of the first page of output for the SUBPORT command: 
INPUT: SUBPORT 0 OF PORT 5 



SUBPORT ATTRIBUTE BLOCK DESCRIPTOR: 5 800001 
00(00) 0 E2E4C2 D70000 MYSUBPORTADDRESS 
01(01) 0 000000 000500 INTERFACE MODEL 

PORTID 

LOCALTRANSATT 
SUBPORTWASCLOSEDATT 
DISCONNECTING 
02(02) 0 00013F 000780 PORTINBOUNDSTATE 

PORTOUTBOUNDSTATE 
SUBPORTOUTBOUNDSTATE 
SUBPORTINUSE 
SUBPORTDATAWASLOST 
SUBPORT IS READABLE 
BNAV2 CLEANUP KLUDGE 
LOGREC PORTINFO SETUP 
SUBPORTSTATE 
MAXCENSUS 
MAXRECSIZE 

03(03) 0 000000 000000 MAXBLOCKEDTIMEOUT 

DIALOGCHECKINT 
RESUMEREADY 
DIALOGPROTOCOLTYPEATT 

04(04) 0 000000 000000 ICPCOMPRESS 

ICPCANCOMPRESS 
COMPRESS IONREQUEST 
COMPRESSIONCONTROL 
COMPRESSIONUSEFULATT 
TRANSLATINGATT 

05(05) 0 000000 B80000 PASSIVEOPEN 

OPENAVAILABLE 
DONOTSEARCHNETWORK 
YOURUSERCODEUNSPECIFIED=TRUE 
YOURHOSTUNSPECIFIED = FALSE 
YOURHOSTNULL =TRUE 



F02667 
=0(0) 
=0(0) 
=5(5) 
=0(0) 
=0(0) 
=FALSE 

= 'NOT READY' 
= 'NOT READY' 
= ' NOT READY' 
=FALSE 
=FALSE 
= FALSE 
= FALSE 
= FALSE 

=SUBPORT STATE (l)=CLOSED 
=63 (3F) 
=1920(780) 
=0(0) 
=0(0) 
=0(0) 
=0(0) 
=FALSE 
= FALSE 
-FALSE 
= FALSE 
=FALSE 
=FALSE 
= FALSE 
= FALSE 
= FALSE 
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06(06) 0 000000 E00000 



YOURHOSTGROUPNUL 

YOURNAMENULL 

SB_COLLECT_ERROR 

RSVP DISPLAY CHANGES 

IN SECONDARY QUEUE 

ACTUALCHARACTERSET 

SUBPORTERROR 

SPREASONCODE 

DIALOGPRIORITY 



=TRUE 
=TRUE 
= FALSE 
= FALSE 
= FALSE 
=0(0) 

=SUBPORT ERROR (0)=NO ERROR 

=0(0) 

=0(0) 



REQUESTEDDIALOGPRIORITY=0(0) 



DIALOGPRIORITYLIMIT 
MINORSTATE 

SUBPORT IS WRITEABLE 
SECONDARY IN PROGRESS 
RESPONSE TYPE 
DIALOGUTILIZATION 



=7(7) 

=MINORSTATE (0)=CLOSED0 

= FALSE 

=FALSE 

=0(0) 

=0(0) 



SUMMARY 



The SUMMARY command lists information about all the stacks in the system. The 
user can control what information is displayed about the stacks and can control the 
order in which the stacks are displayed. 

<summary> 
— SUMMARY 



summary item>- 



sort specs; 



<summary item> 

CREATION - 
KIND 



- MIXNO 

- NAME 

- PIB -t— <PIB cell name> 



— 1 — *-r l D t 

L- # — <offset> 

- RELEASEID 

— STACK — i— <stack base cell name= 



-r: 



# — <offset>- 



- STACKINFO 

- STACKNO — 



- STACKSTATUS 

- STATUS 

- TAB — i— <TAB cell name>- 
L- # — <offset> — 

- TCP — <hex number> 

L TYPE 



<sort specs> 

— SORT BY -L-/3\- ITEM — <integer^ 



- ASCENDING . 
L DESCENDING 
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The following text describes the meaning of each construct: 



SUMMARY 



SUMMARY <summary 
item> 



SUMMARY <summary 
item> <sort specs > 



CREATION 

KIND 

MIXNO 
NAME 

PIB <PIB cell name> 
PIB # <offset> 

RELEASEID 



STACK <stack cell 
name> 

STACK # < offset > 



The following information is displayed for each stack in the 
system: stack number, mix number, name, kind, status, and 
type. Active stacks and the stack that took the dump are 
identified. 

This form of the command allows the user to specify which 
information is to be displayed for each stack in the system. The 
stack number is always displayed. There is a restriction on the 
number of items that can be displayed based on the size of each 
item selected and the display medium requested (for example, 
terminal or printer). If the user requests too many items, an error 
message is displayed. 

PIB <PIB cell name> and PIB # <offset> identify the 
word that is to be displayed from each stack's PIB. 

STACK <stack base cell name> and 

STACK # <offset> identify the word that is to be displayed 

from each stack. 

TAB <stack base cell name> and TAB # <offset> 
identify the word that is to be displayed from each TAB. 

This form of the command allows the user to sort the stacks by 
up to three of the items specified in the summary item list. The 
item to be sorted is identified by its numerical position in the 
summary item list. For the first item in the list, use the 
<integer> 1; for the second, use <integer> 2, and so forth. 
Stack number is the default sort item, and any ambiguity 
remaining after all other sorting is finished is resolved by 
comparing stack numbers. The user can explicitly sort by stack 
number by referencing it as ITEM 0, which might be useful if 
stack number is to be the second of three sort items. 

The final option for the sort specification is the order that the 
item should be sorted in; ascending is the default. STACKINFO, 
STACKSTATUS, and items in the stack or the PIB are sorted 
numerically; all other items are sorted alphabetically. 

Displays the creation date and time for the object code file of 
each process. 

Displays the process kind, such as MCP, independent runner, 
segment dictionary, or frozen library. 

Displays the mix number of each, process. 

Displays the name of each process (normally the object code file 
title). 

Displays the contents of the specified PIB cell for each process. 



Displays the RELEASEID file attribute of the object code file of 
each process. This file attribute, if not null, reflects the Mark 
release level of the object code file. 

Displays the contents of the specified stack cell for each process. 



continued 
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continued 



STACKINFO 



Displays the STACKINFO word for each process. 



STACKNO 



Displays the stack number for each process. 



STACKSTATUS 



Displays the STACKSTATUS word for each process. 



STATUS 



Displays the current process status, such as READY, WAITING, 
or FROZEN. 

Displays the task control processor (TCP) with which a process 
is associated. 



TCP <hex number> 



TYPE 



Displays the process type, such as PROCESS, RUN, and so on. 



Note: If TCP is used as a summary item for a dump from a machine that 
has no TCP, then DUMPANALYZER displays the following error 
message: "ERROR: SCANNING TCP". 

Examples 

The following is an example of the output from a SUMMARY command: 
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INPUT: SUMMARY 



STK 


MIX # 


NAME 


KIND 


STATUS 


TYPE 


012 


16/16 


*SYSTEM/MCP/39018A ON DISK. 


MCP 


FROZEN 




014 


0/0 


ETERNALIR. 


I.R. 


READY 


RUN 


02B 


0/0 


ANSWERING/SERVICE/04. 


I.R. 


WAITING 


RUN 


02C 


0/0 


AREAMANAGER. 


I.R. 


ASLEEP 


RUN 


02D 


0/0 


HANDLEIOPEVENTS. 


I.R. 


READY 


RUN 


02 E 


0/0 


HUNGIOHANDLER. 


I.R. 


READY 


RUN 


033 


0/0 


ANABOLISM. 


I.R. 


WAITING 


RUN 


034 


0/0 


ONESECONDBURDEN. 


I.R. 


READY 


RUN 


036 


4353/4353 


*SYSTEM/38/CENTRALSUPPORT . 


LIB 


WAITING 


RUN 


037 


2/2 


CONTROLLOR. 


I.R. 


READY 


RUN 


038 


3/3 


MAINTLINEIR. 


I.R. 


READY 


RUN 


039 


0/0 


PLM. 


I.R. 


READY 


RUN 


03 B 




*SYSTEM/38/CENTRALSUPP0RT ON D 


SEGD 


UNEMPLOYED 




03C 


2/6 


*SUBSIDIARYTASK. 


I.R. 


WAITING 


PROC 


03 F 


4354/4354 


*SYSTEM/GENERALSUPPORT. 


LIB 


FROZEN 


RUN 


040 




*SYSTEM/GENERALSUPPORT ON DISK 


SEGD 


UNEMPLOYED 




042 


4355/4355 


*SYSTEM/WFLSUPPORT. 


LIB 


FROZEN 


RUN 


043 




*SYSTEM/WFLSUPPORT ON DISK. 


SEGD 


UNEMPLOYED 




046 


4359/4359 


"PRINT SUBSYSTEM INITIALIZATIO 


I.R. 


WAITING 


RUN 


048 


4361/4361 


" JOBFI LE/CONVERTER" . 


I.R. 


READY 


RUN 


049 


4356/4356 


*SYSTEM/DISKCACHESUPP0RT/38. 


LIB 


FROZEN 


RUN 


04B 


4357/4357 


*SYSTEM/PRINT/SUPPORT. 


LIB 


WAITING 


RUN 


04C 




*SYSTEM/DISKCACHESUPP0RT/38 ON 


SEGD 


UNEMPLOYED 




04D 


0/0 


"SLOG MONITOR". 


I.R. 


READY 


RUN 


04E 




*SYSTEM/PRINT/SUPPORT ON DISK. 


SEGD 


UNEMPLOYED 




04 F 


4358/4358 


*SYSTEM/ JOB FORMATTER. 


LIB 


FROZEN 


RUN 


050 




*SYSTEM/JOBFORMATTER ON DISK. 


SEGD 


UNEMPLOYED 




057 


0/0 


0 LAY SCOUT. 


I.R. 


READY 


RUN 


058 


0/0 


KEYIN. 


I.R. 


BLOCKED 


RUN 
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The following example requests that four items be displayed, and requests that the 
stacks are sorted by the PIB word CLOCKONTIME in descending order; in other 
words, the stacks that were most recently on the processor are displayed first. 

INPUT: SUMMARY MIXNO NAME PIB CLOCKONTIME SORT BY ITEM 3 DESCENDING 



STK 


MIX # 


NAME 


CLOCKONTIME 


0F5 


2776/2776 


"->MARC<-". 


0 


000387 


0E8A72 ACT 


7DB 


8297/3640 


(CBG)OBJECT/PM/ACCESS ON PACK. 


0 


000387 


0E87EB DUMP 


02B 


0/0 


IDLE/PROCESSOR/05. 


0 


000387 


0E7265 


02D 


0/0 


IDLE/ PROCESSOR/04. 


0 


000387 


0E719A 


0DC 


2726/2763 


*SYSTEM/COMS. 


0 


000387 


0E70B7 


07C 


2722/2722 


*SYSTEM/CANDE. 


0 


000387 


0E6B4D 


037 


2/2 


C0NTR0LL0R. 


0 


000387 


0E68D0 


06 F 


2718/2718 


"NSP109/03". 


0 


000387 


0E1D9B 


0AC 


2710/2735 


SYSTEM/BNAMCS. 


0 


000387 


0DA990 


729 


2738/5931 


STATUS/CHANGE/SFA15AB. 


0 


000387 


0D174C 


014 


2751/2751 


ETERNALIR. 


0 


000387 


0B953F 


06E 


2717/2717 


"NSP111/04". 


0 


000387 


0B8DE4 


0EE 


2773/2773 


(ANGUS) OBJECT/PROGRAM/AGENT/CO 


0 


000387 


0B8091 


0CF 


2710/2754 


SYSTEM/X25MONITOR. 


0 


000387 


0A7420 


0D8 


2726/2760 


COMS/TANK. 


0 


000387 


0A1873 


06D 


2716/2716 


*SYSTEM/PRINT/ROUTER. 


0 


000387 


09DF97 


1D5 


2738/2970 


TASKING/MESSAGE/HANDLER. 


0 


000387 


09D270 


07A 


0/0 


"CALL WS SHERIFF". 


0 


000387 


099B04 


1D4 


2738/2969 


TASKING/STATE/CONTROLLER. 


0 


000387 


098D77 


140 


2722/2850 


*CANDE/STACK01. 


0 


000387 


098A40 



SWAPANAL 

Note The SWAPANAL command has been deimplemented. This command 
had meaning only on systems with ASN memory, which is not 
supported on the Mark 3.9 system software release and later releases. 

TAB 

The TAB command displays the contents of task attribute blocks (TABs). 
<tab> 

— TAB -j- VIA — <ASD number> ,—, , 1 

AT — <simple address>— 1 L <tab constants— 1 

The following text describes the meaning of each construct: 

TAB AT <simple Displays the contents of the TAB starting at <simple address> . 

address> 

TAB VIA <ASD number> Displays the contents of the TAB pointed to by the ASD at <ASD 

number>. 

<tab constant> Limits the display to include only the TAB word with an offset of 

<tab constant> . 
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For more information about tasks, refer to the PIB command. 
Example 

Figure 4-30 shows an example of the output from the TAB command. 
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INPUT: TAB VIA 2AF0 



- . 


_ 


TAB 


00 




0 


400008 


01 
02 




0 


266088 




0 


000000 


03 




0 


000000 


04 




0 


000000 


05- 


09 


0 


000000 


0A- 


OE 


0 


000000 


OF- 


13 


0 


000000 


14- 


16 


0 


000000 


17 




0 


002201 


18 




Q 


000000 


19 




5 


800000 


1A- 


1C 


0 


000000 


10 




5 


800000 


1E- 


IF 


0 


000000 


20 




5 


800000 


21- 


22 


0 


000000 


23 




5 


800000 


24- 


26 


0 


000000 


27 




5 


800000 


28 




0 


000000 


29 




5 


800000 


2A- 


2E 


0 


000000 


2F 




0 


000020 


30 




0 


000000 


31 




n 


nnnnnn 


32 




0 


000000 


33- 


34 


0 


000000 


35 




5 


EOOOOO 


36- 


38 


0 


000000 


39 




0 


000050 


3A 




0 


000000 


3B 




0 


000000 


3C 




0 


000000 


30 




0 


000000 


3E 




0 


000000 


3F- 


40 


0 


000000 


41 




0 


007FFF 


42 




0 


08601F 


43 




0 


000000 


44 




0 


800013 


45 




0 


400000 


46- 


49 


0 


000000 


4A 




0 


000009 


4B 




0 


05C000 


4C 




0 


000000 


40 




0 


090101 


4E 




0 


02CSC2 


4F 




0 


000000 


50 




0 


000000 


51 




0 


000000 



17C331 T1MESTARTE0 

35C407 DISKINTPERM 

000000 DISKINTTEMP 

000131 I N I TPB I TKOUNT 

059206 INI TPBITTYME 

000000 I0C0UNT1 

289892 OTHERPBITCOUNT 

000000 OISKUSEO 

000000 SURROGATE INFO 

000000 WFL JOB INFO 

000006 ACCESSCODE 

202B15 BACKUPFAMILY 

000000 CHARGECOOE 

402AF8 FAMILYSUB 

000000 HOSTNAME 

502B14 MYBDNAME 

000000 MYFPB 

802AF1 MYNAME 

000000 MYPPB 

302AF3 SOURCENAME 

000000 SUBSYSTEMS 

402AF4 TASKMCSNAME 

OOOOOO TASKSTRING 

304421 VAL IDITYBITSTAB 

000000 OAVAIUE 

0Q4E86 COOECORE 

00250F DATACORE 

000000 DISKLIMIT 

00210E OEXCEPTIONTASK 

000000 MAXIOTIMETAB 

000004 MISCTAB INFO 

080162 ->OPTION 

000000 PARTNER 

028080 PATHCONTROL 

000000 PRINTLIMIT 

000050 OPRIORITY 

000000 PUNCHLIMIT 

FFFFFF SAVEMEMORYL IMIT 

8C1F8C SERIAL 

001770 STACKL IMIT 

8004FD OSTACKSIZE 

000080 OSTATIONINFO 

000000 SWAPSPEX 

000000 TASKERROR 

000000 TASKL IMIT 

000000 TEMPF ILELIM1T 

0504C9 OUSERCOOE 

000000 (USERC00E2) 

OOOOOO USERC00E3 

004003 USERCODEPRlV 

OOOOOO WAITLIMIT 



9 0:05:25 AFTER HALTLOAD » 6935.84110 SECONDS PRIOR TO OUMP 



« 305 

* 0.8761488 SECONDS 
I0C0UNT2 HISTORY 
OTHERPBITTIME PROCESSTIME 
HSINFO ITINERARY 
TASXPARAMS TEMPF1LEMBYTES 



» SYSKITS 

DBEQTNBLK DESTNAME 
DISK = MCPMAST OTHERWISE DISK 
0 ST I TLE 

> LISTING/39COMSUTIL/BIND 
MY LPB 



IOTIMETAB 
STOPPOINT 
L INESPR INTED 



MYSTACKH1 STORY 

CARDSPUNCHED 

PROCESSINFO 



uvISi5IS]9 8JECT/PR 9 G .5?t!^5. E . M I/.?P^ s 0N mcpmast 

MYPR I NTOEFAUL TS 



PSEUOOOOOOO 



SUPPRESSWARNING 



= *SYSTEM/COMS ON DISK 

LOCKEDEVENT ( LOCKE0EVENT2 ) PARTNERGRAPHHEAD PARTNERGRAPHLINKS 



ELAPSEDLIMIT 

MAXPROCESSTIMETAB MAXWAIT 



(ORG MCS=2 LSN=141) 
» 80 

RESTARTCOUNT 
« 549755813887 

= 6000 

»312+1277«1589 



TAPECOUNT 

= 150994944 

TASK0ECLARER=05C 

■ MIKEB 



TAPEPOOL 



TARGETTIME 



PR I VLEDGED USER, MCS ABSTAINING, HS SPECIAL PRIVS ALLOWED 
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TCPINFO (RMM Systems) 



The TCPINFO command displays state information that is maintained by the task 
control processor (TCP). Because only RMM systems have TCPs, this command is valid 
only on dumps from RMM systems. 

<tcpinfo> 
— TCPINFO 



- ALL 

- EVENT -r- ALL 

L-<hexadecimal number^ 



' — STACK — i— ALL 

L-<hexadecimal numbers 



The following text describes the meaning of each construct: 
TCPINFO 



TCPINFO ALL 

TCPINFO EVENT ALL 

TCPINFO EVENT 
<hexadecimal number> 

TCPINFO STACK ALL 

TCPINFO STACK 
<hexadecimal number> 



This simple form of the command displays the number of events 
and process stacks that have been allocated. 

Displays state information for all process stacks and events. 

Displays state information for all events. 

Displays state information for the specified event. 

Displays state information for all process stacks. 
Displays state information for the specified process stack. 



Example 

Figure 4-31 shows an example of the output from a TCPINFO STACK < hexadecimal 
stack number> command and a TCPINFO EVENTS ALL command. 
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INPUT: TCPIMFO STACK CA 



STACK OCA TCP DATA: OOOOOO 085001 
ANALYSIS: STATE » BLOCKEO. OSEO, 
ORIG. BASE PRI > 1850 
_ PROCESS STATISTICS: 

500000 



UU 


OOOOOO 


01 


SCOOOO 


02 


240000 


03 


OOOOOO 


04 


OOOOOO 


05 


000010 


06 


OOOOOO 


07 


OOOOOO 


08 


OOOOOO 


09 


OOOOOO 


OA 


OOOOOO 


OB 


OOOOOO 


OC 


1E0E80 


00 


1E0E80 


OE 


1E0E80 


OF 


OOOOOO 


10 


OOOOOO 


11 


OOOOOO 


12 


OOOOOO 


13 


OOOOOB 


14-1F 


OOOOOO 



0000A4 
OOOOOO 
1B0420 
OOOOOO 
OOOOOO 
000002 
OOOOOO 
OOOOOO 
OOOOOO 
7BE031 
7BB44A 
7BE026 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
BAOBAD 
OOOOOO 



:REAOY 

INPUT: TCPINFO EVENTS ALL 

760 EVENTS ALLOCATEO IN TCP 



EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 
EVENT 



0000 F: 
00020: 
00022: 



00029: 
0002 B: 



00001 
00002 
00010 
00021 
00023 
00024 
00025 
00026 
00027 
0002A 
0002C 
OOO20-OOO2E 
0002 F 
00030 
00031 
00032 

00033-00034 
00035 
00036 
00037 
00038 
0003A 
0003C 
00040 
00041 
00043 
00045 



■00039: 
-00038: 
■0003F: 

00042: 



-0004< . 
-00047: 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



^OOOOOO 014000 OOOOOO 061424 OOOOOO 061401 

BASE PRI = 1850. FINE PRI * 01, CLASS » 5 

MAXPROCESSTIME - 0 

TOTAL MAXPROCESSTIME 
PROCESSTIME 
TOTAL PROCESSTIME 
READYTIME 
TOTAL READYTIME 
PROCESSOR VISITS 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



549755813887 
0.3564936 SECONDS 



3138264 SECONDS 
0547416 SECONDS 
0547416 SECONDS 



EXPIRATION TIME 9 0:03:58 AFTER HALTLOAD * -8.694696 SECONDS PRIOR TO DUMP 



RETURN PARAMETER 1 
RETURN PARAMETER 2 
P2 PARAMETER 



LAST ALIVE 
LAST WAITING 
LAST REAOY 



0:03:57 AFTER HALTLOAD 
0:03:57 AFTER HALTLOAD 
0:03:57 AFTER HALTLOAD 



-7.721604 SECONOS PRIOR TO DUMP. 
-7.6946304 SECONDS PRIOR TO DUMP 
•7.7215776 SECONDS PRIOR TO DUMP 



HEAD OF OWNED EVENTS QUEUE 
EVENT WAITING TO PROCUREADBAD 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



C08000 

cooooo 

C08000 

cooooo 

C08000 
COOOOO 
C48000 
COOOOO 
C08000 

cooooo 

C08000 

cooooo 

D08000 
OOOOOO 
C48000 
DOOOOO 
C08000 
COOOOO 
C08000 
C48000 

cooooo 

OOOOOO 
COOOOO 
C08000 
DOOOOO 
C08000 

cooooo 



OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
00002C 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
000035 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
00002 F 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 
OOOOOO 



NOT HAPPENED 
NOT HAPPENEO 
NOT HAPPENED 
NOT HAPPENEO 
NOT HAPPENEO 
NOT HAPPENED 

NOT HAPPENED, WAITING STACKS: 



02C 



NOT HAPPENED 
NOT HAPPENED 
NOT HAPPENED 
NOT HAPPENED 
NOT HAPPENED 
HAPPENED 
HAPPENED 

NOT HAPPENED, WAITING STACKS: 035 

HAPPENED 

NOT HAPPENED 

NOT HAPPENED 

NOT HAPPENED 

NOT HAPPENED, WAITING STACKS: 02F 

NOT HAPPENED 

HAPPENED 

NOT HAPPENED 

NOT HAPPENED 

HAPPENED 

NOT HAPPENED 

NOT HAPPENED 



DUMPANALYZER 



TERMINAL 



The TERMINAL command permits the user to control the following features of 
terminal output when viewing DUMPANALYZER output: 

Whether the terminal output is sent a page at a time or a line at a time 
The number of characters per line 
The number of lines per page 

Whether the pages are transmitted continuously or with page breaks 
Whether the output is right-justified 

Whether characters at the end of a line are truncated or printed on the next line 
Whether the characters appear in upper- and lowercase or only in uppercase 

The default values for the TERMINAL command are as follows: 

FULLPAGE ON (for screen devices); FULLPAGE OFF (for nonscreen devices) 
WAIT 
PAGE 22 
LINE 80 

TRUNCATE OFF 
UPPERCASE OFF 
RIGHTJUSTIFY OFF 

The TERMINAL command can be used at any DUMPANALYZER prompt. 
<terminal> 



— TERMINAL 



-/l\-r- CONTINUOUS 
I— w/i 



-/1\- FULLPAGE 



r 



OFF 



WAIT 



-/1\- PAGE — <number>— 
-/1\- LINE — <number>— 

-/1\- TRUNCATE -> 

L- OFF 

1-/1\- UPPERCASE 



L- OFF 



L-/l\- RIGHTJUSTIFY 



r 



OFF 



The following text describes the meaning of each construct: 



TERMINAL 

TERMINAL FULLPAGE 
(OFF) 

TERMINAL 
CONTINUOUS 



4-136 



This form of the command displays the current values for all of 
the TERMINAL options. 

This form of the command causes output to be sent a page (or 
line) at a time. 

This form of the command causes terminal output to be sent 
without pauses between pages. 

continued 
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continued 



TERMINAL WAIT 



TERMINAL PAGE 
<number> 

TERMINAL LINE 
<number> 

TERMINAL 
RIGHTJUSTIFY (OFF) 



TERMINAL TRUNCATE 
(OFF) 



TERMINAL UPPERCASE 
(OFF) 



This form of the command causes terminal output to wait for 
user input between pages. Terminal output is continued by 
entering one or more blanks. If a positive number (N or +N) is 
entered, only the next N lines are displayed instead of the next 
page. Any other input entered at a page break is a new 
command; output is discontinued for the previous command. 

This form of the command sets the number of lines per page. 



This form of the command sets the number of characters per 
line. 

This option is valid only when TRUNCATE is disabled. When a 
line of output is longer than the terminal width, the excess 
characters are right justified on the following line if the 
RIGHTJUSTIFY option is enabled. 

This form of the command causes output that does not fit on a 
line to be right justified on the following line. The 
RIGHTJUSTIFY option must be enabled when the TRUNCATE 
option is enabled. 

When the TRUNCATE option is disabled, output that does not fit 
on a line is truncated. 

When the UPPERCASE option is enabled, lowercase output is 
converted to uppercase. 

When the UPPERCASE option is disabled, lowercase output is 
not converted to uppercase. 



Example 

DUMPANALYZER displays the current terminal settings in response to each 
TERMINAL command, as shown in the following example: 

INPUT: TERM RJ 

FULLPAGE ON, WAIT, PAGE = 23, RJ ON, TRUNCATE OFF, UP OFF, LINE = 80 



TRACE 

The TRACE command causes the current tracetable, or a portion of the tracetable, 
to be printed. The tracetable is generated by the trace facility, a general purpose 
operating system debugging aid available when the MCP compile-time option TRACE 
is set. The TRACE facility allows for tracetable entries to be made at predefined points 
in the MCP called CONDITIONALDUMP stops, each of which is associated with a 
particular statement in the MCP. Each stop has two parameters, a stop number and 
an info word. The stop number is a two digit hex number that is different for each 
stop. A new set of CONDITIONALDUMP stops is in effect for each Mark release level. 
Information about the conditions under which the stops are reached is given in the 
tracetable entry. The tracetable holds about 1650 entries in a circular queue; when the 
last slot has been filled, the next entry overwrites the first entry. 
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<trace> 



— TRACE 



I KftUC — | 

I— < 



entries number 



73 



r 



CD 



<CD number>- 

- CPM — <CPM number>— 

- SHOW — — 



I— STACK — <stack number>- 

<entries number> 
<CD number> 
<CPM number> 
<stack number> 

These are each <number>s. 

The following text describes the meaning of each construct: 
TRACE 

TRACE <entries number> 



TRACE CD <CD number> 



TRACE CPM <CPM number> 



TRACE SHOW 



TRACE STACK <stack number> 



TRACE <entries number> CD <CD 
number> 

TRACE <entries number> CPM <CPM 
number> 

TRACE <entries number> SHOW 
TRACE <entries number> STACK <stack 
number> 



The entire tracetable is printed. 



The most recent <entries number> of 
entries to the tracetable are printed. 

Tracetable entries with the specified 
conditional dump number are printed. 

Tracetable entries with the specified central 
processing module (CPM) number are 
printed. 

All SHOW messages are printed. SHOW 
messages are displayed in EBCDIC and 
DEADSTOP information is displayed in 
hexadecimal form. 

Tracetable entries in the specified process 
stack are printed. 

The most recent <entries number> of 
entries to the tracetable are searched, and 
the entries meeting the specified CD, CPM, 
SHOW, or STACK criteria are printed. 



Ex.a.iilpie 

Figure 4-32 shows an example of the output from the TRACE command. 
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INPUT: TRACE 15 

** MOST RECENT ENTRIES APPEAR FIRST ** 




P2 PARAMETER IN PROCEDURE 



0A0020 
OA0020 
OA1020 
B00409 
804809 
000000 
800000 
800434 
OOOOOQ 004834 
BC2A00 404819 
0A0BC2 A0041E 
000000 00481E 
BC2800 404819 
005800 020000 
002000 200003 



OPENLTFILE 
OPENLTF I LE 
OPENLTFILE 

INITIATEUSERPSEUDOIO 
19 I ATEUSERPSEUDOIO 
INITIATEUSERPSEUDOIO 
INITIATEUSERPSEUOOIO 
INITIATE0IRECTCHAR10 
IN T ATEOIRECTCHARIO 
IN TIATEOIRECTCHARIO 
INITIATEUSERPSEUDOIO 
INITIATEUSERPSEUOOIO 
INITIATEUSERPSEUDOIO 
BLAST WAITING STACK 
SUPERWAIT 



9 SEQ# / RCW CALLED FROM PROCEDURE 



9 SOI:PIR:PSR / SEQUENCE 



29085255 
29085255 
29085230 
29085230 
29291240 
29291155 
29252500 
29134220 
29134220 
29097830 
13509160 
14650720 



LOGHANDLER 
LOGHANDLER 

INITIATEUSERPSEUDOIO 

INITIATEUSERPSEUOOIO 

INITIATEUSERPSEUDOIO 

INITIATEUSERPSEUDOIO 

UDCACHESIZE 

UDCACHESIZE 

UDCACHESIZE 

I NIT I ATEOIRECTCHARIO 

IN IT I ATEOIRECTCHARIO 

I NIT I ATEOIRECTCHARIO 

DUMPDCDLP 

BLAST WAITING STACK 



18 



B74 
B74 
B72 
103E 

oil 

11C8 
11C8 
11C8 
103E 
103E 
103E 
1195 
1021 



043A 
0430 
0089 
07E0 

8?I§ 

07E0 
004 F 
004F 
004 F 
0C14 
0C14 
0C14 
0002 
045B 



36907440 
36907440 
36869760 
29179920 
9179920 



IIP 



* 9920 
6981260 

mm 

19232520 

mm 

13509160 
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USE 

The USE command lists commands that were saved by the KEEP command. (Refer to 
the KEEP command.) 

<use> 

— USE — j— <number>— } 1 

I — ? I 

The following text describes the meaning of each construct: 

USE <number> The command that was saved and labeled <number> by the 

KEEP command is listed. The <number> variable must 
evaluate to a decimal integer between 0 and 9. 

USE? A list of the commands saved by the KEEP command is printed. 

Example 

INPUT: USE ? 

00 : HDR 

01 : MD 1C33 FOR 6 

02 : MD STK 6A BOSR FOR 3 

For more information, see the discussion of the KEEP command in this section. 

{ 

WHERE 

The WHERE command displays the location of a specified < global ID>. The location is 
expressed as the offset relative to D[0]. 

All aliases for MCP stack cells are retained and recognized by the WHERE command. 
<where> 

— WHERE — <global ID> 1 



Example 

INPUT: WHERE GETJOBINFO 

SEG #156A GETJOBINFO OF JOBREQUEST OF GETSTATUS 
PCW @ 0321 SEG #1111 GETJOBINFO 



WHO 

The WHO command displays the global identifier for the specified D[0] offset (cell). An 
outer-block procedure PCW is shown as SEG:PIR:PSR from the D[0] stack image. For 
an outer-block procedure code segment, the names, PCW D[0] offsets, and PCWs are 
shown for all procedures in that segment. 

All aliases for MCP stack cells are retained and are returned by the WHO command. 
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<who> 

— WHO — <number> ■ 1 

Examples 

INPUT: WHO 321 

0321 (PCW 1111:0000:0) GET JOB INFO 
INPUT: WHO 320 

320 (PCW 7D6:0044:0) CCCHECK FORMORE 

Error Messages 

The following error messages are displayed if an abnormal condition occurs. 
ACCEPT: WRONG CODE FILE - OK OR RESTART. 

The code file timestamp on disk did not match the timestamp on the dump tape. The 
operator should enter OK to use the code file on disk or RESTART to cause the code file 
to be closed and DUMPANALYZER to be suspended. DUMPANALYZER proceeds if OK 
is specified. 

DISPLAY: DUMP TAPE HAS BAD INFORMATION IN RECORD <#>, AT 
LOCATION <#>. 

Data on the dump tape failed the consistency check, causing DUMPANALYZER to 
terminate. 

DISPLAY: BAD DATA RECOVERY IN RECORD <#>, AT LOCATION <#>. 

Data on the dump tape failed the consistency check, but redundancies in the way 
that these data were stored on the tape allowed limited recovery of that data. 
DUMPANALYZER then proceeds. 

DISPLAY: BAD DUMPANALYZER INPUT CARDS 

DUMPANALYZER was unable to decipher an input card. The card image appears on 
the printout with a line of asterisks (*) pointing to the unknown word, and processing 
terminates. 

DISPLAY: BAD MCP STACK POINTER 

DUMPANALYZER found that the stack vector descriptor at D[0]+2 did not address 
present memory. This condition is usually due to a premature end-of-file condition 
on the dump tape or to improperly taking the last memory module offline when no 
MEMDUMP disk is available, causing termination of processing. DUMPANALYZER 
should be rerun with RAWDUMP and DEBUG set; DUMPANALYZER then produces a 
raw dump of the contents of the tape without checking D[0]+2. 



8600 0478-100 



4-141 



DUMPANALYZER 



DUMPANALYZER FAULT <#> messages are given for the first, second, third, fourth, 
and tenth faults and for every tenth fault thereafter (20, 30, 40, and so forth). 

DISPLAY: CANNOT ANALYZE - MCP INCOMPATIBLE WITH 
DUMPANALYZER. 

The MCP level recorded on the dump tape did not match the level of DUMPANALYZER. 
This incompatibility can be avoided by ensuring that the level of DUMPANALYZER is 
always exactly the same as the level of the MCP that wrote the dump tape. 

DISPLAY: CANNOT ANALYZE - USE PREVIOUS DUMP ANALYZER 

The level of the MCP as recorded on the dump tape was lower than the level compiled 
into DUMPANALYZER, causing DUMPANALYZER termination. The proper level of 
DUMPANALYZER must be used for a rerun. 

DISPLAY: ERROR UNABLE TO GENERATE GLOBAL IDENTIFIERS, 
CAUSE = < cause >. 

One of four < cause >s caused failure in the MCP global identifier routine. Two of these 
< cause >s indicate either improper compilation, a DUMPANALYZER bug, or code file 
corruption (LEVEL and SIZE). I/O exceptions give rise to the other two <cause>s, 
RDMCP (code file) and RDFILE (internal file). Global name generation is terminated, 
NONAMES is invoked, and DUMPANALYZER analysis proceeds. DUMPANALYZER 
can be rerun with the DEBUG command to get a program dump of the terminated 
global identifier routine. 

DISPLAY: SAVE ABORTED FOR INSUFFICIENT DISK SPACE 

The SAVE command was aborted because there was not enough disk space available to 
hold the saved dump file. 

DISPLAY: SAVE ABORTED FOR DIRECT I/O ERROR, RD=<result 
descriptor> 

The SAVE command was aborted due to a disk unit read or write error. The < result 
descriptor> gives information about the error. 
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Section 5 

HARDCOPY and PRINTCOPY 



This section describes the HARDCOPY and PRINTCOPY utility programs, which 
provide a way to save operator display terminal (ODT) input commands and system 
messages in a disk file and print the contents of that file. 

HARDCOPY 

The HARDCOPY utility program uses the DCALGOL intrinsic ATTACHSPOQ for 
initialization to receive copies of all ODT "traffic," which includes all input commands 
and system responses. System responses are received in the HARDCOPY task 
language. All messages received by HARDCOPY are reformatted by replacing control 
characters with blanks, condensing multiple blanks to a single blank, and dividing 
messages into 132-character print lines. HARDCOPY then writes the reformatted 
commands and messages into a disk file titled *HARDCOPY. This disk file is created 
with a PROTECTION file attribute value of PROTECTED. 

On systems running InfoGuard security enhancement software, the *HARDCOPY file 
can be public or private, depending on the value of the NONUSERFILES option of 
the SECOPT (Security Options) system command. For information about this option, 
refer to to A Series Security Administration Guide. On non-InfoGuard systems, the 
♦HARDCOPY file is public. 

When the HARDCOPY program is initiated, it searches for an existing file titled 
♦HARDCOPY. If the file HARDCOPY exists, the last recorded message is located, and 
a message indicating a restart is added at the end of the file. If the file HARDCOPY 
is not found, one is created. Every 15 minutes, a message giving the time and date 
can be inserted into the file. The insertion is done only if entries have been made in 
HARDCOPY. 

After the first message that extends into the last segment of HARDCOPY is written, 
the file HARDCOPY is closed and its title is changed to HARDCOPIES/< integer >. The 
integer is incremented by one each time a new HARDCOPIES file is created. A new file 
titled HARDCOPY is created at this time. PRINTCOPY is automatically initiated to 
print the file. 

The contents of HARDCOPY can also be printed in sequential pieces. Each time a HI 
(Cause EXCEPTIONEVENT) system command is directed at HARDCOPY, a run of 
PRINTCOPY is requested that prints all messages since the last Hi-initiated printing. 
(Refer to the A Series System Commands Operations Reference Manual for further 
information about the HI command.) 
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Running HARDCOPY 

In order to maintain a hard copy of ODT traffic, an installation must first ensure that 
HARDCOPY and PRINTCOPY are loaded on disk, and then do one of the following: 

• Designate HARDCOPY as a supervisor program by entering the following CS 
(Change Supervisor) system command. (Specifying HARDCOPY as a supervisor 
program causes the program to be automatically initiated after a halt/load.) 

CS SYSTEM/HARDCOPY 

• The following is an example of a Work Flow Language (WFL) job that runs 
HARDCOPY: 

BEGIN JOB; 

RUN SYSTEM/HARDCOPY; 
END JOB 

Disk File Format 

Record number 0 of a HARDCOPY file contains the following information, which is 
used for naming copies and controlling PRINTCOPY: 



Word Contents 

0 The integer used for naming the file 

1 The record number of the first word following the last recorded message 

2 The number of valid words within the record specified by word 1 

3 The record number containing the first word of the first message that has 
not been printed by a HI (Cause EXCEPTIONEVENT) system command 

4 The number of valid words within the record specified by word 3, which 
precedes the first unprinted record 

5-29 Not used 



The remaining records contain ODT input commands and system messages. The first 
word of each message has field 47:8 equal to 1 and field 39:40 equal to the length of the 
message (not including the first word) as five EBCDIC numeric characters. The last 
message in the file is always followed by a word with all bits equal to zero. 

PRINTCOPY 

The PRINTCOPY utility program is primarily a disk-to-printer program. PRINTCOPY 
reads records from a HARDCOPY disk file and writes them to a direct line printer file. 
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Running PRINTCOPY 

The following is an example of a WFL job that runs PRINTCOPY: 

BEGIN JOB; 

RUN SYSTEM/PRINTCOPY (<integer>); 
END JOB 



The < integer > variable is a value that determines which file and how much of the file 
is to be printed. If <integer> is zero, the file selected is HARDCOPY. Otherwise, the 
file selected is HARDCOPIES/<file number > where <file number > is the absolute 
value of <integer>. If a HARDCOPIES/<file number> file is selected, it will be 
removed after being printed. 

If a negative < integer > is specified, only previously unprinted portions of the file are 
printed. Otherwise the entire file is printed. When HARDCOPY initiates PRINTCOPY 
in response to a HI command, HARDCOPY passes a negative value to PRINTCOPY. 

The following example specifies that the file HARDCOPIES/3 is to be printed: 

RUN SYSTEM/PRINTCOPY (3) 
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Section 6 

HDU System Balancing 



System balancing is a feature of the operating system that is used to balance or tune an 
HDU (A 12 or A 15) system to a set of operations. The user can monitor the overall 
system utilization and can change various software parameters that affect system 
utilization. 

SYSTEMSTATUS is used to collect the system utilization statistics. The U (Utilization) 
system command is used to display the current system utilization statistics, including 
percentages of central processor unit (CPU), I/O, operating system (MCP), and total 
system use. The U command is described in the A Series System Commands Operations 
Reference Manual. 

The Statistics display is divided into two parts: processing utilization and I/O 
utilization. These statistics and the accounts that they are applied to are described 
in the A Series System Commands Operations Reference Manual and the A Series 
SYSTEMSTATUS Programming Reference Manual. 

Dynamic Variation of System-Balancing Parameters 

Dynamic Variation of System-Balancing Parameters is the ability to change, while the 
operating system is running, certain software parameters that control the flow of the 
operating system. In particular, the user is given the ability to specify the operating 
system I/O interrupt scheme and the ability to change the system utilization time 
interval. Both of these parameters can be altered or interrogated by using the SBP 
(System Balancing Parameters) system command. (Refer to the A Series System 
Commands Operations Reference Manual for more information about the use of this 
command.) 

The keyword SBP can be entered followed by one of two parameters: INTERVAL (used 
to change the system utilization time interval) and IOINTERRUPT (used to change 
the operating system I/O interrupt schemes). SBP with no parameter following it 
causes the current values of INTERVAL and IOINTERRUPT to be displayed. The 
INTERVAL is expressed in terms of seconds and IOINTERRUPT is a choice of four 
interrupt strategies. The SBP command can take one of the following forms: 

SBP (request display of current balancing parameters) 

SBP INTERVAL <number> (for example, SBP INTERVAL 300) 

SBP IOINTERRUPT Q EMPTY 

SBP IOINTERRUPT IOFINISH 

SBP IOINTERRUPT IDLE 

SBP IOINTERRUPT WAITING 

SBP IOINTERRUPT WAITING QEMPTY 
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INTERVAL Parameter 

INTERVAL is a user-specified parameter, and has a default value of 10 seconds (a small 
time interval). A small interval gives an immediate picture of system utilization, and a 
large interval gives a more overall, averaged picture. With a small interval, radical 
changes are accurately reflected. With a large interval, radical changes are "smoothed 
out." The user can use a larger interval for an overall picture, but one smaller than 10 
seconds is not recommended because the statistics tend to fluctuate too much. 



IOINTERRUPT Parameter 

IOINTERRUPT is the system balancing feature that allows a choice of four I/O 
interrupt strategies. The differences among the four involve the way various types of 
jobs interact and include the amount of CPM time devoted to handling I/O completes. 
The four interrupt strategies are as follows: 

QEMPTY Specifies that the IOM or lOMs interrupt a CPM when the last I/O request 

for any unit is completed and on every I/O completion if a CPM is idle. 

IOFINISH Specifies that IOM or lOMs interrupt a CPM upon handling every I/O 

completion. This causes I/O bound jobs to run in a shorter elapsed time, 
but requires more CPM time to handle I/O completions. 

IDLE Provides for no I/O interrupts except when a CPM is idle. The effect of this 

is to bias CPM usage toward CPM-bound jobs. This requires the least 
amount of CPM time for handling I/O completions. 

WAITING Specifies that I/O interrupts occur upon completion of an I/O operation only 

if a process is waiting for that I/O or if a CPM is idle. As long as the 
progress of no process is dependent on the completion of a particular I/O 
operation, the IOM generates no interrupt. The effect of this strategy is to 
use just enough CPM time to keep I/O bound jobs running. 

This WAITING interrupt strategy can be specified along with QEMPTY by using the 
following form of the SBP system command: 

SBP IOINTERRUPT WAITING QEMPTY 

IOINTERRUPT WAITING QEMPTY is the default strategy when none is specified. 



Implementation 

The SETSTATUS procedure of the operating system handles the SBP command. 
Within SETSTATUS, operating system global variables are altered to change the 
interval or IOINTERRUPT strategy. If the user wishes to change the system 
balancing parameters from a user program, he can use the DCKEYIN function of 
DCALGOL, or he can invoke SETSTATUS, in which case he should refer to the 
SYSTEMBALANCINGPARAMETERS procedure in the CONTROLLER software for 
specific details of input formats, and so forth. 
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System-Balancing Usage 

System balancing can be used in a number of ways. By observing system utilization 
and changing system-balancing parameters, the user can "tune" the system to help 
achieve maximum throughput. The user can also "bias" the system toward a specific 
type of application; for instance, IOINTERRUPT on idle biases the system towards 
process-bound jobs and IOINTERRUPT on every I/O FINISH biases the system 
towards IO-bound jobs. Another use is to record and graph utilization throughout the 
day, enabling the user to distribute the system load on an equitable basis. In general, 
system balancing should enhance the user's knowledge and control of the system. 
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Section 7 
LOGANALYZER 



The LOGANALYZER program is designed to produce a report consisting of all 
SUMLOG entries that correspond to parameters set by the user. LOGANALYZER 
extracts the specified types of entries from the log and formats them for display. The 
report LOGANALYZER produces can be listed on a terminal screen, sent to a printer 
or placed in a file. 

LOGANALYZER examines any log file specified by the user. However, if no log file is 
specified, it analyzes the current SUMLOG file. The user can limit the LOGANALYZER 
search to entries in the log file that were made during a particular time period. 

Any of various <loganalyzer options > can be used to extract log entries of a certain 
type, such as log entries that record job activity or that record various kinds of errors. 
If none of these <loganalyzer options > are specified, all entry types are included in 
the report. A description of all types of log entries can be found in "SUMLOG" in this 
manual. 

Installing Related Libraries 

LOGANALYZER uses the system libraries JOBFORMATTER and SDASUPPORT. 
These libraries must be present as support libraries that appear in the SL (Support 
Library) system command display. 

Depending on user privileges and the logfile security set for systems with InfoGuard 
installed, the SDASUPPORT library is used as a filter on the analyzed SUMLOG file 
records. Refer to the USERCODE option for a description of the SDASUPPORT 
filtering procedure. 

Additional system libraries are required for analysis of certain log entry types. The 
following are these libraries, which should be defined by the SL system command: 

• The BNAV2TRANSLATION library is necessary for analysis of BNA Version 2 log 
entries. 

• The HWERRORSUPPORT library is necessary for complete analysis of Major 
Type 2, Minor Type 23 (Mainframe Hardware Report) entries. If this library is not 
available, LOGANALYZER performs a partial analysis of these log entries. 

• The SITESUPPORT library is necessary for analysis of Major Type 7 (Installation) 
entries. It can also be used for customizing log reports. If this library is unavailable, 
LOGANALYZER generates a HEX dump of the SUMLOG entry for Major Type 7 
or performs the standard formatting of the SUMLOG entries for any other Major 
Type. 
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Analyzing Logs from Different Releases 

The current LOGANALYZER is able to analyze logs generated under the same Mark 
release level or the immediately preceding Mark release level. For example, the 4.0 
LOGANALYZER could analyze 4.0 or 3.9 logs. 

It is also possible to run LOGANALYZER on a system running a different Mark release. 
LOGANALYZER automatically checks the JOBFORMATTER and SDASUPPORT 
libraries to determine if they are of the same Mark release as LOGANALYZER. If not, 
LOGANALYZER attempts to link to these libraries under function names prefixed with 
the Mark level -for example, 40JOBFORMATTER and 40SDASUPPORT. The operator 
should use the SL command to install these libraries under the correct function names. 



Finding Missing Log Entries 

If the LOGANALYZER report does not include log entries that you expected to be 
there, it might be due to one of the following reasons: 

• You might need to use the LOGGING (Logging Options) system command to 
enable logging of the specified log entry type. Refer to "Selecting the Entry Types 
to be Logged" in Section 12, "SUMLOG." 

• On InfoGuard systems, by default LOGANALYZER excludes entries with a 
usercode different from the usercode under which the LOGANALYZER process 
runs. This is the case even if LOGANALYZER is running under a privileged 
usercode. To see all log entries, it might be necessary to run LOGANALYZER under 
a privileged usercode and also to specify "USERCODE ." in the LOGANALYZER 
command. Refer to the discussion of the USERCODE option later in this section. 



Running LOGANALYZER 



LOGANALYZER can be initiated from a CANDE or MARC session, an ODT, or a WFL 
program. The following table shows the commands or selections available for initiated 
LOGANALYZER from each of these sources: 

Source Input 

CANDE, ODT, LOG <option list> command 

CANDE, MARC, RUN *SYS TEM/LOGANALYZER C<option list>°) command 
ODT, WFL 

MARC LOG selection on LOG menu 

Note: When the RUN command is used, the entire <option list> must be 
enclosed in quotation marks. For individual options that include 
string values, these string values must be enclosed in double sets of 
quotation marks. 

If LOGANALYZER is to be run on an operator display terminal (ODT) configured to 
be in data comm mode, it should be run through Menu-Assisted Resource Control 
(MARC). 
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Once LOGANALYZER is running, the user can find out how much of the log has 
been analyzed at a given moment by entering ?HI on a CANDE terminal or <mix 
number > HI on an ODT. The following is an example of the display that is returned 
when ?HI or ?2660HI (through CANDE) is entered: 

#2660 DISPLAY: LOG 60% READ. 



When the LOG option is selected from MARC, a series of screens is presented that 
allow the user to select options for a LOGANALYZER report. 



Option List 



The < option list> allows the user to specify the input file to be used by 
LOGANALYZER, the destination of the LOGANALYZER output, the range of records 
to be searched, and the types of records to be searched for. 

<option list> 

L-<device option>— I 



— / — <integer>- 

— " — <logname>- 



— <time>- 



E 



<date>— 



!— <date>- 



L- TO -p <time>^ 
L-<date>- 

L-<loganal yzer options>— 1 I— STOP -J 
<device option> 



1— <date; 



ODT 



h CONSOLE - 
REMOTE — 
DCSTATION 
h PRINTER - 



h LINEPRINTER 

TEXT — " — <fi1e title; 



<1 ogname> 



:usercode; 
i * 



-<name of log file>- 



ON — <fami"ly name> 



3 



If the < option list> is empty, the effect is the same as if the user had specified LOG 
ALL. Refer to "Selection Options" in this section for information about the ALL option. 
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The following text describes the meaning of each variable: 

<device option > Controls the output destination of the LOGANALYZER output. 

The PRINTER and LINEPRINTER options cause the output to be 
printed in lines of 132 characters. 

The TEXT option causes the output to be written to the file with the 
specified <file title > . If a file of the same <file title> already 
exists, LOGANALYZER replaces it with a new file. By default, the 
file has a FILEKIND file attribute value of DATA and 132 character 
records. If LOGANALYZER is run with the SW1 task attribute set to 
TRUE, the file is created with FILEKIND value of TEXTDATA and 80 
character records, which are sequentially numbered with an 8-digit 
number at the end of each record. If LOGANALYZER is discontinued 
before completing its run, the DATA or TEXTDATA output file 
preserves the output generated up to that point. 

When LOGANALYZER is invoked from an ODT, the ODT and 
CONSOLE options cause output to be displayed on that ODT, 
assuming that the device has been set up with visible ETX 
characters. The REMOTE and DCSTATION options also cause 
output to be displayed on the originating ODT, assuming that the 
device has been set up with invisible ETX characters. The output is 
displayed in pages of 23 lines, with 80 characters per line. 

When LOGANALYZER is invoked from a remote terminal, the 
REMOTE, DCSTATION, ODT, and CONSOLE options cause output to 
be displayed on that terminal. If the terminal is set up as a screen 
device, the output is consistent with the terminal screen size and 
width definitions. You can use the CANDE TERM command to 
alter the defines of the terminal screen size and width. For more 
information, see the A Series CANDE Operations Reference 
Manual. The default device option for remote terminals is 
REMOTE; otherwise PRINTER is assumed. 

The VALUE task attribute can be used to change the default number 
of lines per page and characters per line. The lower three digits of 
the VALUE attribute represent the number of characters per line; the 
fourth and fifth digits represent the number of lines per page. The 
number of lines per page can be from 12 through 64; the number 
of characters per line can be from 40 through 256. The following 
examples show the use of the VALUE attribute: 

• LOG REMOTE ; VALUE=27132 sets the page size to 27 lines, 
with 132 characters per line. 

• LOG PRINTER;VALUE=80 sets the number of characters per 
line to 80. 

• LOG ODT; VALUE= 170000 sets the page size to 17 lines. 

continued 
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continued 



/<integer> The/<integer> notation (where <integer> is a 6-digit number) 

specifies that the log file to be analyzed has the title 
SUMLOG/<system serial number>/<current date>/<integer> and 
is located on the same family as the current system log. The log file 
title generated by this specification has the same format as the title 
created for the old system log file when the log is released by the TL 
(Transfer Log) system command. Refer to the A Series System 
Commands Operations Reference Manual for information on 
the TL command. For example, if the user is on a system with a 
serial number of 227, and the current date is August 22, 1983, 
then including /000005 in the option list would cause 
LOGANALYZER to use the file named 
SUMLOG/227/082283/000005 as its input file. 

<logname> The <logname> is a valid file title for a log file and must be entered 

in uppercase. If a usercode is specified, LOGANALYZER appends 
the usercode to the file name; otherwise, it assumes a nonusercode, 
*(star) file, is requested. LOGANALYZER assumes all log files to be 
on the family that was specified for LOG when using the DL (Disk 
Location) system command unless the ON <family name> part of 
the <logname> syntax is used. Using the ON <family name> 
syntax causes the program to look for the log file on the specified 
family. Refer to the A Series System Commands Operations 
Reference Manual for information on the DL command. 

Note: If a RUN command is used to initiate 

LOGANALYZER, and the <option list> is 
enclosed in quotation marks, the <logname> 
must be enclosed in a double set of quotation 
marks. 

<time> A four-digit integer denoting time in an HHMM format or a six-digit 

integer denoting time in an HHMMSS format (H is hours; M is 
minutes; S is seconds). For example, 1:45 is represented as 1345 
and 3:30:18 p.m. is represented as 153018. Leading zeros are 
required. For example, 9:15 a.m. must be represented as 0915, 
and 12:05:12 a.m. as 000512. If no start time is specified, 0000 
is used. If no stop time is specified, 2400 is used. 

<date> The date for the LOGANALYZER report in the form mm/dd/yy, where 

mm, dd, and yy stand for month, day, and year, respectively. For 
example, June 1, 1983 is 06/01/83. If only one date is specified, it 
is used as both the start and stop date for the time range. If no date 
is specified, the following factors determine the default range: 

• If a <time> is specified, or if the last entry in the log file has 
today's date, then today's date is used as both the start and 
stop date for the time range. 

• Otherwise, the date range includes the full range of dates in the 
log file. 

STOP Signifies the end of input. All input records after STOP are ignored 

by LOGANALYZER. The use of STOP is optional; if STOP is not 
entered, LOGANALYZER inserts a STOP at the end of the input. 
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LOGANALYZER Options 

There are two kinds of LOGANALYZER options. Selection options select log entries of 
a particular type to be included in the LOGANALYZER output. Output options affect 
the destination to which the LOGANALYZER output will be sent and the format of the 
report. 

<loganalyzer options> 



— 1 — i— <se1ection options> i ' 1 

I— <output options> ' 

Most LOGANALYZER options are additive options. That is, if more than one option is 
specified, all entries that satisfy any of the specified options are listed. However, the 
ABORT, ERRORS, IDENTITY, JOB, MIX, SESSION, and TASK options are restrictive 
options. If any restrictive options are specified, then only entries that satisfy all of the 
specified restrictive options are listed. If a combination of restrictive and additive 
options is used, then only entries that satisfy all of the restrictive options and at least 
one of the additive options are listed. 



Selection Options 

Selection options choose particular types of log entries for inclusion in the 
LOGANALYZER output. The output illustrations for the following options appear in 
"Output Illustrations" later in this section. 

<selection options> 

— DATE 1 1 

_ ALL 

- RAW 



1 — I — r— <configuration and maintenance options>— i — ' — ' 

— <data comm options> 

— <di agnostics options> 

— <job/task/session options> 

— <additional selection options> 

The following text describes the meaning of each option: 

DATE Lists the date and time of the first and last log entries. This information is 

printed on all LOGANALYZER reports. The DATE option, if specified, must 
be the only option requested. The output of the DATE option is illustrated in 
Figure 7-i. 

ALL Lists the entire log. The output of the ALL option is illustrated in Figure 

7-2. 

RAW Lists an unanalyzed hexadecimal dump of the entire log file. The output of 

the RAW option is illustrated in Figure 7-3. 



Configuration and Maintenance Options 

These options select log records related to the hardware and software configurations of 
the system and problems that are encountered during operation. 
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configuration and maintenance options> 
CONFIG 



- CPUERROR - 

- FASUMMARY 

- HL 



IOSUMMARY 
1- MAINFRAME 

IOERROR 
1- MAINT 



<device option; 



The following text describes the meaning of each option: 



CONFIG 



CPUERROR 
FASUMMARY 



Lists all hardware and software configuration log records. The 
configuration is logged at each halt/load occurrence and again 
each time the log is transferred or initiated. The output of the 
CONFIG option is illustrated in Figure 7-4. Figure 7-5 shows an 
example of the CONFIG output for a memory configuration 
record on an A 10 system. 

This option is synonymous with MAINFRAME. 

Lists a table of failure counts against Field Replaceable Units 
(FRUs) for the A 17 resource management module (RMM). The 
table resembles the output from the FAS (Failure Analysis 
Summary) system command. The FASUMMARY option is 
available only when analyzing A 17 logs. If the FASUMMARY 
option is used when analyzing a non-A 17 log, LOGANALYZER 
displays the following message: 



HL 



IOSUMMARY 



MAINFRAME 



FASUMMARY ONLY ALLOWED ON A17 SUMLOGS 

The FASUMMARY is implicitly set if the MAINFRAME option is 
used when analyzing an A 17 log file. 

The output of the FASUMMARY option is illustrated in Figure 
7-6. 

Lists the system halt/load history. The output of the HL option is 
illustrated in Figure 7-7. On A 1 through A 6 systems, 
automatic power log entries are also analyzed. Examples of 
automatic power log entries appear at the end of this topic. 

Lists the table that summarizes IOERROR log entries. Individual 
errors are not printed. The summary is the same as that 
produced at the end of a MAINT or IOERROR request. The 
output of the IOSUMMARY option is illustrated in Figure 7-8. 

Lists all mainframe log records such as box failures, system error 
actions, halt/load, and dump records. The output of the 
MAINFRAME option is illustrated in Figure 7-9. 

If the log file being analyzed was produced on an A 17 system, 
the MAINFRAME option implicitly causes the FASUMMARY 
option to be set. 



continued 
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IOERROR 



MAI NT 



<device option> 



Lists all peripheral error entries. If IOERROR is followed by a 
<device option> , only the peripheral error entries for the 
selected device type and unit number are listed. The output of 
the IOERROR option is illustrated in Figures 7-10 and 7-11. 

Lists all mainframe errors, peripheral errors, and hardware 
configuration log records. If MAI NT is followed by a <device 
option>, the hardware configuration log records are not included 
and only the mainframe and peripheral errors for the selected 
device type and unit number are listed. The output of the MAI NT 
option is illustrated in Figures 7-12 and 7-13. This command 
also analyzes automatic power log entries generated on A 1 
through A 6 systems. Examples of automatic power log entries 
appear at the end of this topic. 

Figure 7-14 shows an example of the single-bit memory error 
report produced by the MAI NT CPU command on an A 10 
system. 

Can be specified after the IOERROR or MAINT option. Causes 
LOGANALYZER to select only those records that satisfy the given 
IOERROR or MAINT option and also apply to the selected device 
type or device and unit number. The output of the <device 
option> is illustrated in Figure 7-15. 



The following diagram lists the many device options available. 
<device option> 



DUMPEX TRD 

CD 

CP 

CPU 

CR 

DC 



I- DECODE EXTRD H 

DK 

HC 

HY 

IP 

LP 

MT 

NRZ — 

NRZMT 

NRZ7 

h NRZ7MT 



NRZ9MT 

PE 

PEMT - 

PK 

PP 

SC 

VC 



unit number 
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The device mnemonic definitions are as follows: 



Mnemonic Definition 

CD CD-ROM unit 

CP Card punch unit 

CPU Central processing unit 

CR Card reader unit 

DC EMS data communications unit 

DK Memory Disk unit 

HC Host Control (HC) unit 

HY HYPERchannel® unit 

IP Image printer 

LP Line printer unit 

MT Magnetic tape unit 

NRZ, NRZMT Nonreturn-to-zero (NRZ) magnetic tape unit 

NRZ7, Nonreturn-to-zero (NRZ) 7-track magnetic tape unit 
NRZ7MT 

NRZ9, Nonreturn-to-zero (NRZ) 9-track magnetic tape unit 
NRZ9MT 

PE, PEMT Phase-Encoded (PE) magnetic tape unit 

PK Disk unit 

SC Operator display terminal 

VC Voice channel 



The DUMPEXTRD and DECODEEXTRD options affect the analysis of log entries for 

those device types that have extended status information or request sense information 

(for example, native SCSI devices). For all such devices except HYPERchannel,® f 

DUMPEXTRD displays a hexadecimal dump of the extended status information. 

DECODEEXTRD displays a formal analysis of the same information. 

Expanded analysis for HYPERchannel devices is produced only if either DUMPEXTRD 
or DECODEEXTRD is used in conjunction with the MAINT HY option. Requesting 
the option DUMPEXTRD in conjunction with a MAINT HY request causes the 
message proper and sense bytes to be presented in raw format without description. For 
example, the "LOG MAINT HY DUMPEXTRD" request produces the following output 
in addition to the normal "LOG MAINT HY" output: 

MESSAGE PROPER : <first 16 bytes of the message proper> 

ADAPTER SENSE BYTES DATA : <adapter sense byte information> 



HYPERchannel is a registered trademark of Network Systems Corporation. 
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If the option DECODEEXTRD is requested in conjunction with a MAINT HY request, 
the message proper and sense bytes are given expanded analysis. 

Examples of Automatic Power Log Entries for A 1 through A 16 Systems 
The following is an example of a scheduled automatic power-off entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST FEB 01, 1987 17:20:16 REASON: 
SCHEDULED 

The following is an example of an unscheduled automatic power-off entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST FEB 28, 1987 09:12:16 REASON: 
UNSCHEDULED 

The following is an example of a thermal overload warning entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST MAR 15, 1987 04:48:59 REASON: 
THERMAL WARNING 

The following is an example of a thermal overload power-off entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST MAR 15, 1987 04:55:37 REASON: 
- THERMAL OVERLOAD 

The following is an example of a cancelled pending power-off operation entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST FEB 01, 1987 17:30:27 REASON: 
CANCELLED 

The following is an example of an actual power-off entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST MAY 07, 1987 19:28:31 REASON: 
ACTUAL POWEROFF 

The following is an example of an actual blower failure entry: 

SYSTEM 1001 AUTOMATIC POWER REQUEST JUL 25, 1987 19:28:31 REASON: 
BLOWER FAILURE 
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Data Comm Options 



The following options select log records that are related to data communications: 

<data comm options> 
BNA 



h BNAV2 
COMS - 



- HLCN 

- IDC - 
MCS - 

h NMS - 



- CONFIG 
L WINDOW 



- LCF - 

- NCF - 

- SNMP - 
L- OTHER 



I- NSP 
SNA 



- REPORT - 

- TRACE - 

- ERROR — 

- INQUIRY 

- COMMAND 
L OTHER — 



I— TCPIP 



h TCP — 

IP 

h ARP — 
RIP — 

- UDP — 

- ICMP — 

- TCPMGR 
PIM — 
SNMP - 

>- OTHER - 



The following text describes the meaning of each option: 
BNA 



BNAV2 



COMS 



Lists all BNA Version 1 log records. The output of the BNA Version 1 option 
is illustrated in Figure 7-16. 

Lists all BNA Version 2 log records. Analysis of BNA Version 2 records 
requires that the BNA translation library, BNAV2TRANSLATION, be 
specified using the SL (Support Library) system command. The output of 
the BNA Version 2 option is illustrated in Figure 7-17. 

Lists the records reporting COMS events. If COMS is followed by CONFIG, 
only the COMS configuration change records are selected. If COMS is 
followed by WINDOW, only the COMS window activity records are selected. 



HLCN 

IDC 

MCS 



Lists the Host LAN Connection (HLCN) records. 
Lists the IDC and ID records. 

Lists all MCS log records. The output of the MCS option is illustrated in 
Figure 7-18. 



continued 
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NMS Lists all nondiagnostic commands, responses, and reports generated for 

Network Management. 

When NMS is followed by a subordinate option, LOGANALYZER selects 
only the entries related to that option. The following list defines the 
subordinate options: 

• LCF. Lists the Local Control Facility entries. 

• NCF. Lists the Network Control Facility entries. 

• SNMR Lists entries from the SNMP agent. 

• OTHER. Lists the miscellaneous entries. 

NSP Lists all data comm log records. The output of the NSP option is illustrated 

in Figure 7-19. 

SNA Lists all nondiagnostic commands, responses, and reports generated for 

Systems Network Architecture (SNA). 

When SNA is followed by a subordinate option, LOGANALYZER selects only 
the entries related to that option. The following list defines the subordinate 
option: 

• REPORT. Lists noteworthy network events. 

• TRACE. Lists the network frame reported as a result of the TRACE + 
command. 

• ERROR. Lists unexpected fault conditions. 

• INQUIRY. Lists the solicited status requests and responses. 

• COMMAND. Lists the solicited action requests and responses. 

• OTHER. Lists the miscellaneous events. 

continued 
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continued 



TCPIP Lists all nondiagnostic commands, responses, and reports generated by the 

TCP/IP network provider. 

When TCPIP is followed by a subordinate option, LOGANALYZER selects 
only the entries related to that option. The following list defines the 
subordinate options.- 

• TCP. Lists the Transmission Control Protocol layer entries. 

• IP Lists the Internet Protocol layer entries. 

• ARP. Lists the Address Resolution Protocol function entries. 

• RIP Lists the Route Information Protocol function entries. 

• UDR Lists the User Datagram Protocol layer entries. 

• ICMR Lists the Internet Control Message Protocol function entries. 

• TCPMGR. Lists the TCP Manager function entries. 

• PIM. Lists entries for the connection open and close reports. 

• SNMP. Lists entries generated during the process of an SNMP 
command. SNMP commands are logged under Major Type 28, 
Network Management. 

• OTHER. Lists the miscellaneous entries. 



Diagnostics Options 



These options select log records created by diagnostics options of various system 
software products. 
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<di agnostics options> 
— DIAGNOSTICS 



ALL 

r « 



-/1\- HLCN 



-/1\- MHS 



-/1\- DIR 



-T— ALL 



-/1\- DSS 



<DIR subtype: 



17 



-r- ALL 



<DSS subtype>- 



T 



-r- ALL 



HLCN subtype>- 



L 



-|- ALL 

LX_<mi- 



-/1\- NIS 



-/1\- NMS 



-/1\- OSI 



<MHS subtypes- 



r 



— T— MLL 

L- J— <NIS subtypes- 



I— L.<m 



<NMS subtype>- 



IT 



-r- ALL 

la; 



-/1\- SNA - 
-/1\- TCPIP 



<OSI subtypes- 



ALL — ) 



ALL 

« 



<TCPIP subtype>- 



) - 1 



J 



The DIAGNOSTICS options each correspond to minor types and subtypes of the Major 
Type 19 (Diagnostics) log entry. Note that the SNA minor type has no subtypes. For 
a description of this log entry, refer to the "SUMLOG" section of this manual. The 
following are the minor types corresponding to each DIAGNOSTICS option: 



DIAGNOSTICS Minor Type 
Option Number 


Minor Type Name 


DIR 


12 


OSI directory 


DSS 


1 


Distributed systems service 


HLCN 


11 


Host LAN Connection 


MHS 


4 


Message Handling System 


NIS 


7 


Network-independent software 


NMS 


13 


Network Management System 


OSI 


5 


Open Systems Interconnection 


SNA 


16 


Systems Network Architecture 


TCPIP 


6 


TCP/IP 
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The subtype options, such as the <DSS sub types >, limit the search to specific subsets 
of the diagnostic records logged for each minor type. For a list of the possible subtypes 
for each minor type, refer to the discussion of the Diagnostics Record (Major Type 19) 
in the "SUMLOG" section of this manual. In that discussion, each subtype is identified 
by a JOBFORMATTER define name. The last part of each JOBFORMATTER define is 
the same as the corresponding LOGANALYZER subtype. For example, the SUMLOG 
discussion lists a define called LOGDIAG_DSS_FTAM under the DSS minor type. 
To request LOGANALYZER to report on this subtype, you would use the option 
DIAGNOSTICS DSS FTAM. 

Table 7-1 shows examples of the ways DIAGNOSTICS options can be combined for 
various effects. 



Table 7-1. DIAGNOSTICS Examples 



Command 


Result 


DIAGNOSTICS 


Retrieves all diagnostics log records. 


DIAGNOSTICS (DSS) 


Retrieves all diagnostics log records for distributed 
systems services (DSSs). 


DIAGNOSTICS (DSS MHS) 


Retrieves all diagnostics log records for distributed 
systems services (DSSs) and the Message Handling 
System (MHS). 


DIAGNOSTICS (NIS (PARSE 
ROUTER)) 


Retrieves all diagnostic log records for the 
network-independent software (NIS) subtypes PARSE 
and ROUTER. 


DIAGNOSTICS (NIS (PARSE 
ROUTER) MHS (AS MTA)) 


Retrieves all diagnostic log records for the 
network-independent software (NIS) subtypes PARSE 
and ROUTER and the Message Handling System 
(MHS) subtypes AS and MTA. 



For examples of output from the DIAGNOSTICS option, refer to Figures 7-20, 7-21, 
and 7-22. 



Job, Task, and Session Options 

The following options select log records for a job, task, or session activity. Sample 
output for the job, task, and session options are shown in "Output Illustrations" later 
in this section. 
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<job/task/session options> 
ABORT 



I- BOJ — 
BOT — 
DMS — 

- EOJ — 

- EOT — 

- ERRORS 

- FILE - 

10 

LIB — 
PRINTS 



-<integer>- 



REQUEST -J 
JOB — <job number>- 



u 



THRU — <integer>- 



L 



/l\-r- JOB 



THRU — <job number? 



-<name>- 



L /= J 



<mix number> 

SESSION 
L/IN-t- IDENTITY 



L THRU 
<mix number>- 



-<mix numbers- 



L 



THRU — <mix number>- 



I— <mi 



ix n umber >- 



L- THRU — <mix number>— 



MIX — <mix number>- 



L thru — 



THRU — <mix number>- 



L- TASK 



I 



cname>- 



L /= J 



<mix number>- 



L- THRU — <mix number>- 



The following text describes the meaning of each option: 



ABORT 



BOJ 



BOT 



DMS 



EOJ 



EOT 



ERRORS 



FILE 



10 



Lists the records associated with tasks that terminated abnormally with a 
DS or QT. The ABORT option cannot be used simultaneously with the 
APPEND, CREATE, or UNSORTED option. The output of the ABORT option 
is illustrated in Figure 7-23. 

Lists the beginning of job records. The output of the BOJ option is 
illustrated in Figure 7-24. 

Lists the beginning of job and beginning of task records. The output of the 
BOT option is illustrated in Figure 7-25. 

Lists the database OPEN, CLOSE, FREEZE, and RESUME records. The 
output of the DMS option is illustrated in Figure 7-26. 

Lists the end of job records. The output of the EOJ option is illustrated in 
Figure 7-27. 

Lists the end of job and end of task records. The output of the EOT option 
is illustrated in Figure 7-28. 

Lists the records associated with compiler tasks that terminated with syntax 
errors. The ERRORS option cannot be used simultaneously with the 
APPEND, CREATE, or UNSORTED option. The output of the ERRORS 
option is illustrated in Figure 7-29. 

Lists the following records: file OPEN, CLOSE, and INTERVAL; BNA port 
activity; and file status entries. The output of the FILE option is illustrated 
in Figure 7-30. 

Lists the file OPEN, CLOSE, INTERVAL, and BNA port activity records. 

continued 
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IDENTITY Lists identity records. Identity records establish, change, or end the identity 

for a mix number. The following are identity records: 

• BOJ = Beginning of job 

• EOJ = End of job 

• BOT = Beginning of task 

• EOT = End of task 

• LOGON = MCS session log-on 

• LOGOFF = MCS session log-off 

• El = Establish identity 

IDENTITY <mix number> lists the identity records associated with the 
specified mix number. 

IDENTITY <mix number> THRU <mix number> lists the identity records 
for all mix numbers that fall within the specified range. 

The IDENTITY option cannot be used simultaneously with the MIX or TASK 
options. 

continued 
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Lists the records associated with the specified job and its tasks. 

JOB "<name>" lists the records for the job whose BEGIN JOB statement 
contains the specified <name>. The <name> parameter uses the same 
format as a file title. 

JOB "<name>/=" lists all jobs whose high-level identifier matches the 
specified <name>. The comparison is like a file title tested for 
membership in a file directory. For example, JOB (ME)TOO/= selects jobs 
named (ME)TOO/A or (ME)TOO/B, but not (ME)TOO. 

A name parameter can consist of a "<string>" construct. JOB ""<string>"" 
lists the records associated with the job whose job name matches the 
specified string. For example, the following command lists the records for 
the BEGIN JOB "MY JOB" statement: 

LOG JOB ""MY JOB" " 

In general, you should classify jobs with names that have embedded blanks 
as strings rather than as file names. This rule applies to a number of 
system commands (or DCKEYIN) commands. For example, to list the log 
records of a RB ON PACK system command, use the following command: 

LOG JOB ""RB ON MY PACK" " 

Note: If a RUN command is used to initiate LOGANALYZER, 
and the <option list> is enclosed in quotation marks, 
then the <name> or <name>/= construct must be 
enclosed in a double set of quotation marks. 

JOB <mix number> lists the records for jobs with the specified mix 
number. JOB <mix number> THRU <mix number> lists the records for 
all jobs whose mix numbers fall within the specified range. The listed 
records include log entries created by the print system when processing 
print requests for the specified mix number or numbers. 

The JOB option cannot be used simultaneously with the SESSION option. 
The output of the JOB option is illustrated in Figure 7-31. 



Lists the library LINK, DELINK, FREEZE, and RESUME records. The output 
of the LIB option is illustrated in Figure 7-32. 

MIX <mix number> lists the records associated with the specified mix 
number. MIX <mixnumber> THRU <mix number> lists the records 
associated with the specified range of mix numbers. A <mix number> of 
zero (0) lists all log records that have no associated mix numbers (for 
example, configuration records). 

The MIX option cannot be used simultaneously with the IDENTITY or TASK 
options. The output of the MIX option is illustrated in Figure 7-33. 

continued 
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PRINTS Lists logs entries that are created by the print system. 

PRINTS <integer> lists the printing entries that are logged for the specified 
print request number. The REQ option is the default option. The <integer> 
THRU <integer> option lists the log entries for all print requests whose 
request numbers fall within the specified range. 

PRINTS JOB <job number> lists the printing entries that are logged for the 
specified job number. The JOB <job number> THRU <job number> 
option lists the log entries for all jobs whose job numbers fall within the 
specified range. 

SESSION SESSION <mix number> lists the records associated with the specified 

CANDE or other MCS mix number. SESSION <mix number> THRU <mix 
number> lists the records associated with the CANDE or other MCS mix 
numbers within the specified range. The SESSION option cannot be used 
simultaneously with the JOB option. The output of the SESSION option is 
illustrated in Figure 7-34. 

TASK TASK "<name>" lists the records associated with the specified task name. 

The <name> parameter uses the same format as a file title. 

TASK "<name>/=" lists all jobs whose high-level identifier matches the 
specified <name>. The comparison is like a file title tested for 
membership in a file directory. For example, TASK "(ME)TOO/=" lists tasks 
named (ME)TOO/A or (ME)TOO/B, but not (ME)TOO. 

Note: If a RUN command is used to initiate LOGANALYZER, 
and the <option list> is enclosed in quotation marks, 
then the <name> or <name>/= construct must be 
enclosed in a double set of quotation marks. 

TASK <mix number> lists the records for tasks with the specified mix 
number. TASK <mix number> THRU <mix number> lists the records for 
all the tasks whose mix numbers fall within the specified range. A 
<mix number> of zero (0) lists all log records that have no associated mix 
numbers (for example, configuration records). 

The TASK option cannot be used simultaneously with the IDENTITY or MIX 
options. The output of the TASK option is illustrated in Figure 7-35. 
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The job, task, and session options use the following logic to select log records for listing: 

• The ABORT, ERRORS, IDENTITY, JOB, MIX, PRINTS, SESSION, and TASK 
options are restrictive options. If more than one is specified, any log record that 
contains all the specified restrictive options is selected, and any log record that 
contains less than all the specified restrictive options is not selected. 

• The BOJ, BOT, DMS, EOJ, EOT, FILE, LIB, and 10 options are additive options. If 
one or more is specified, any log record that contains any of the specified additive 
options is selected. 

• If no options are specified, all records are selected. 

• If one or more restrictive options are specified, and no additive options are specified, 
any additive-type record related to the specified restrictive option is selected. 

• If no restrictive options are specified, and one or more additive options are 
specified, any record containing any of the specified options is selected. 

• If a combination of restrictive and additive options are specified, any record that 
contains all the specified restrictive options and any of the specified additive 
options is selected. 



Additional Selection Options 



The following options list various types of log entries. The output illustrations for these 
options appear in "Output Illustrations" later in this section. 

additional selection options> 



ACCESSCODE — <code identifiers 
- CHARGECODE — <code identifier>- 
COMMENT 



- DEIMPLEMENTATION 

- DRC 

- FIND — 
MSG 



-<wild card string: 



OPERATOR 



RESULT 



<type>- 



SUCCESS 



- FAILURE - 

- RELEVANT - 
VIOLATION 



- SECURITY 

- UNKNOWN - 

- USERCODE 

- USERDATA 
L VOLUMES - 



:code identifier>- 



<code identifier 
-<simple name>- 
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The following text describes the meaning of each option: 



ACCESSCODE 



CHARGECODE 



COMMENT 



DEIMPLEMENTATION 



DRC 



Lists entries associated with the specified <code identifier;*. 
The ACCESSCODE option is valid only on systems with the 
InfoGuard security enhancement software installed. 

To list entries with no accesscode specification, use an asterisk 
(*) as the code identifier. To list entries with the accesscode of 
the LOGANALYZER process, specify an equals sign (=) as the 
code identifier. The accesscode is not interrogated for entry 
selection if a period (.) is specified as the code identifier. If 
ACCESSCODE is specified in combination with CHARGECODE, 
RESULT, and/or USERCODE, only the records that contain all the 
specified options are selected. If ACCESSCODE is used together 
with ALL, then all entries with the specified accesscode and all 
public records are selected. Public records include all 
maintenance and halt/load records. 

Lists entries associated with the specified <code identifiers 
The CHARGECODE option is valid only on systems with the 
InfoGuard security enhancement software installed. 

To list entries with no chargecode specification, use an asterisk 
(*) as the code identifier. To list entries with the chargecode of 
the LOGANALYZER process, specify an equals sign (=) as the 
code identifier. The chargecode is not interrogated for entry 
selection if a period (.) is specified as the code identifier. If 
CHARGECODE is specified in combination with ACCESSCODE, 
RESULT, and/or USERCODE, only the records that contain all the 
specified options are selected. If CHARGECODE is used together 
with ALL, then all entries with the specified chargecode and all 
public records are selected. Public records include all 
maintenance and halt/load records. 

Lists all comments entered into SUMLOG by means of the LC 
(Log Comment) and LJ (Log to Job) system commands. Refer to 
the System Commands Reference Manual for information on the 
LC and LJ commands. The output of the COMMENT option is 
illustrated in Figure 7-36. 

Lists the deimplementation warnings generated by the operating 
system with the associated mix number and task identification. 
The output of the DEIMPLEMENTATION option is illustrated in 
Figure 7-37. 

Causes all disk resource control system entries to be listed. 
These entries include USERDATA record overflow, userdata error, 
and invalid family name in the familylist entry. 



continued 
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FIND Limits the output to those log entries that contain text matching 

the specified <wild card string> . The <wild card string> can 
be any string of characters. FIND causes a case-sensitive, 
partial-word search (that is, the target text is found even if 
embedded in a larger word). 

The <wild card string> can include two types of wild card 
characters: question marks (?) and equal signs (=). A question 
mark in the <wild card string> matches any single character. 
An equal sign in the <wild card string> matches any sequence 
of characters. 

Note: The <wild card string> normally should 
begin and end with equal signs, even if the 
<wild card string > text consists of complete 
words. For example, to find the phrase 
INVALID DESTINATION, the FIND option 
should specify FIND "= INVALID 
DESTINATION^'. 

If multiple FIND options are specified, only the 
last one has effect. For example, the command 
LOG FIND "=HI=" FIND "=BYE=" finds only 
entries that contain the string BYE. 

MSG Lists all system messages and the mix numbers associated with 

these messages. The list includes operator entries as listed by 
the OPERATOR option. The output of the MSG option is 
illustrated in Figure 7-38. 

OPERATOR Lists all ODT entries. When OPERATOR is used with one or 

more <type> specifications, only log entries for the 
corresponding system commands are listed. Each <type> is a 
system command mnemonic, such as DS, MP, OK or PG. Most 
system commands that change the system state are allowed as 
<type>s. PS is a valid <type> and lists log entries that are 
associated only with print system commands that have caused a 
change in the print system. System commands that are inquiries 
but do not change the system state cannot be used as <type>s. 
Refer to the System Commands Reference Manual for all the 
system commands and their mnemonics. The output of the 
OPERATOR option is illustrated in Figure 7-39. 

RESULT Reports are created based on the results of the actions logged. 

These results can be any combination of successful actions, 
failed actions, security-relevant actions, and security violations. 
The results to be reported are specified by entering any 
combination of SUCCESS, FAILURE, RELEVANT, and 
VIOLATION. 

continued 
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Result reports for RELEVANT include actions on the 
USERDATAFILE, use of the system ??SECAD primitive and 
SECOPT commands, and attachments of guard files to files. 

If RESULT is specified with ACCESSCODE, CHARGECODE, 
and/or USERCODE, only the records that contain all the 
specified options are selected. 

The RESULT option is valid only on systems with the InfoGuard 
security enhancement software installed. 

SECURITY Lists security violation records such as INVALID USERCODE. If 

the logfile is private, the user must be privileged to display 
security violation entries. The output of the SECURITY option is 
illustrated in Figure 7-40. 

UNKNOWN Lists a hexadecimal dump of all SUMLOG records with major 

and minor types that LOGANALYZER does not recognize. 

USERCODE Lists entries associated with the specified <code identifiers 

The USERCODE option is valid only on systems with the 
InfoGuard security enhancement software installed. 

To list entries with no USERCODE specification, use an asterisk 
(*) as the <code identifiers To list entries with the USERCODE 
of the LOGANALYZER process, specify an equals sign (=) as the 
<code identifiers The USERCODE is not interrogated for entry 
selection if a period (.) is specified as the <code identifiers If 
USERCODE is specified in combination with CHARGECODE, 
RESULT, and/or ACCESSCODE, only the records that contain all 
the specified options are selected. If USERCODE is used 
together with ALL, then all entries with the specified USERCODE 
and all public records are selected. Public records include all 
maintenance and halt/load records. 

If LOGANALYZER has no direct read access to the analyzed 
SUMLOG file, the only valid <code identifier is the USERCODE 
of the LOGANALYZER process; otherwise, any value is valid. For 
a discussion of direct read access, refer to the "Understanding 
Log Access Security" subsection of Section 12, "SUMLOG." 

Note: On InfoGuard systems, if the USERCODE 

option is not specified in the LOGANALYZER 
run, LOGANALYZER behaves as if 
USERCODE = were set. This is true even if 
LOGANALYZER is running with direct read 
access to the SUMLOG file. If 
LOGANALYZER has direct read access, then 
specifying a period as the <code identifier > 
disables usercode filtering. 

continued 
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USERDATA Lists USERDATA records. USERDATA records are records that 

describe the installation of a *SYSTEM/USERDATAFILE or 
changes to that file. 

VOLUMES Analyzes all the disk and tape volume status records generated 

by the system when a disk or tape volume comes online or goes 
offline, when a tape volume is purged by either the PG or SN 
system command, or when the first file on a tape volume is 
overwritten by a new file. The information displayed by 
LOGANALYZER includes the time, volume serial number, volume 
name, and volume status. 



Output Options 



The following options affect the destination of the LOGANALYZER output or the form 
in which the output is presented. The destination of the LOGANALYZER output can 
also be affected by the CON, PRINTER, and REMOTE options in "Option List" earlier 
in this section. The format of the LOGANALYZER output can also be affected by the 
RAW option in "Selection Options" earlier in this section. The output illustrations for 
these options appear in the subsection titled "Output Illustrations" later in this section. 

<output options> 



APPEND — r— " — <file title; 

- CREATE -J 

- DUMP 



:sort option>- 



L- SORTSIZE — = — <integer>- 



<sort option> 



— SORTED , 1 

L- UN SORT ED -> 

The following text describes the meaning of each option: 

APPEND "<file title>" Places the log records selected for analysis at the end of an 

existing file with the title <file title>, instead of listing them. 
The records are added in the same order as they appear in 
the log file being analyzed. The resulting file has the same 
format as the system log file and can in turn be analyzed by 
LOGANALYZER. The APPEND option cannot be used 
simultaneously with the ABORT, ERRORS, or SORTED 
option because APPEND unconditionally enables the 
UNSORTED option. 

Note: If a RUN command is used to initiate 

LOGANALYZER, and the <option list> is 
enclosed in quotation marks, then the <file 
title> must be enclosed in a double set of 
quotation marks. 

continued 
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CREATE "<file title>" Places the log records selected for analysis in a new file with 

the title <file title>, instead of listing them. If a file with the 
specified <file title> already exists, an error is reported and 
LOGANALYZER terminates. The records are placed in the 
new file in the same order as they appear in the log file 
being analyzed. The resultant file has the same format as 
the system log file and can in turn be analyzed by 
LOGANALYZER. The CREATE option cannot be used 
simultaneously with the ABORT, ERRORS, or SORTED 
option because CREATE unconditionally enables the 
UNSORTED option. 

Note: If a RUN command is used to initiate 

LOGANALYZER, and the <option list> is 
enclosed in quotation marks, then the <file 
title> must be enclosed in a double set of 
quotation marks. 

DUMP Dumps in hexadecimal form each specified log record 

selected by other <loganalyzer options> before listing the 
record in its analyzed form. The output of the DUMP option 
is illustrated in Figure 7-41. 

<sort option > If SORTED is specified, then LOGANALYZER lists the log 

entries sorted into order first by mix number and then by 
type. If UNSORTED is specified, then LOGANALYZER lists 
the log entries in chronological order. The output from the 
UNSORTED option is illustrated in Figure 7-42. The output 
from the SORTED option is illustrated in Figure 7-43. 

The SORTED and UNSORTED values cannot be used 
simultaneously. If neither SORTED nor UNSORTED is 
specified, the <sort option> defaults to UNSORTED in most 
cases. However, the following options can affect the <sort 
option >: 

• The ABORT and ERRORS options implicitly set the 
<sort option > to SORTED. This value cannot be 
overridden. 

• The APPEND and CREATE options implicitly set the 
<sort option > to UNSORTED. This value cannot be 
overridden. 

• The MAI NT option implicitly changes the <sort 
option > default to SORTED. This value can be 
overridden by an explicit assignment of UNSORTED. 

SORTSIZE Overrides the core size default value (4000) for the SORT. 



Examples 

Table 7-2 shows examples of LOGANALYZER commands. 
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Table 7-2. LOGANALYZER Exam pies 



uoiiiinana 


Result 


LOG and LOG ALL 


Retrieves all entries. 


LOG 

"SU M LOG/28 1/09 1 782/000207" 


Retrieves the same information as LOG, except the 
information is from the specified SUMLOG file. 


LOG 5/11/89 


Retrieves all entries for the date 5/11/89. 


LOG 1200 TO 1700 MIX 345 


Retrieves all entries for mix number 345 from 1200 
to 1700. 


LOG FILE and LOG 10 


Retrieves all file OPEN, CLOSE, and INTERVAL 
entries. 


LOG JOB "MYJOB" 


Retrieves all entries for jobs named MYJOB and their 
tasks. 


RUN 

*SYSTEM/LOGANALYZER("JOB 
""MYJOB"""); 


Retrieves the same entries as LOG JOB "MYJOB". This 
example shows the use of a double set of quotes for 
embedded strings in a RUN command. 


LOG NSP 


Retrieves all data comm error records. 


LOG MAI NT DC 


Retrieves all data comm I/O error entries. 


LOG MAI NT DK 


Retrieves all maintenance log entries for memory disk 
units. 


LOG MAI NT 99 


Retrieves all maintenance log entries for a peripheral 

unit with a unit numhpr of 

uiiii wiui ci uiiii 1 i u i 1 1 ui_f i \ji ~/ ~j * 


LOG MAI NT MT 97 60 


Retrieves all maintenance log entries for magnetic 
tape units 97 and 60. 


LOG MAINT PK IOSUMMARY 


Gives a table summarizing all IOERROR records for all 
disks. 


LOG MAINT PK DUMPEXTRD 


Retrieves all mainframe errors and peripheral errors 
for disk devices, and includes the raw extended result 
descriptor for each entry. 


LOG 0900 TO 1000 BNA APPEND 
"SUMLOG/BNA/ENTRIES" 


Retrieves all BNA version 1 entries dated between 
9:00 a.m. and 10:00 a.m. of the current day, and 
inserts them at the end of the already existing file 
SUMLOG/BNA/ENTRIES. 


LOG MAINFRAME UNSORTED 


Retrieves all mainframe log records and reports them 
in chronological order rather than sorting them first by 
type and then by job number. 


LOG JOB 1260 THRU 1380 
MAINT 


Retrieves all mainframe error, peripheral error, and 
hardware configuration log records for jobs numbered 
within the range 1260 to 1380. 


LOG PRINTER IOSUMMARY 


Lists the table that summarizes IOERROR log entries 
and sends the report to a printer. 


continued 
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Table 7-2. LOGANALYZER Examples (cont.) 



Command 


Result 


LOG OPERATOR DS FREE 
ACQUIRE 


Retrieves all entries which record the use of the 
system commands DS, FREE, or ACQUIRE. 


LOG ERRORS BOT EOT MSG 


Retrieves all beginning of task, end of task, and 
system message entries that are associated with tasks 
that terminated with syntax errors. 


LOG BOJ EOJ BOT EOT MSG FIND 

"=(XYZ)=" 


Retrieves all beginning of job, end of job, beginning of 
task, end of task, and system message entries that 
contain the string (XYZ). 


LOG MSG FIND 
"=RECOVERY=REMOVED=" 


Retrieves all system message entries that contain both 
the words RECOVERY and REMOVED. The entries are 
retrieved only if the word RECOVERY precedes 
REMOVED. However, the two words can be separated 
by any amount of text. 


LOG T "LOG/OUT" MSG 


Retrieves all system message entries and writes them ! 
to the file called LOG/OUT. | 



DLP Type Abbreviations 

Table 7-3 lists the data link processors (DLP) type abbreviations used in the 
LOGANALYZER output and the full names of the DLP types they stand for. 



Table 7-3. DLP Abbreviations 



Abbreviation 


Name 


CP1 


CARD PUNCH 


CR1 


CARD READER 


FR1 


DATACOM LSP: SUB-BROADBAND (PROM) 


FR2 


DATACOM LSP: SUB-BROADBAND (RAM) 


FR3 


DATACOM LSP: 56KB BROADBAND BIT 


HC2 


HOST CONTROL-2 


HT1 


STANDARD HOST TRANSFER (DISK) 


HTS1 


SEQUENTIAL HOST TRANSFER (DISK) 


HTS2 


SEQUENTIAL HOST TRANSFER-2 
(B9494-12/B9494-24 DISKS) 



continued 
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Table 7-3. DLP Abbreviations (cont.) 



Abbreviation 


Name 


HY1 


, HYPERchannel PERIPHERAL CONTROL 


ICP1 


INBUILT COMMUNICATIONS PROCESSOR 


IPIPK1 


IPI 9399-H DISK CONTROLLER 


IPIPK2 


IPI M9730 DISK CONTROLLER 


MT1 


PE MAG TAPE 


MT2 


GCR MAG TAPE 


MT3 


9-TRACK NRZ MAG TAPE 


MT5 


GCR FORMATTER-TYPE MAG TAPE 


MT6 


STREAMER TAPE 


ft iTn r%f\ i 

MTFIPS1 


FIPS TAPE 


MTFIPS3 


CARTRIDGE TAPE 


IP 


IMAGE PRINTER 


0DT1 


OPERATOR DISPLAY 


0DT2 


OPERATOR DISPLAY-2 


PKISCSI(NATIVE) 


Native Small Computer System Interface Disk 


SCI 


DATACOM NSP: STANDARD (MODEL 1 & 2) 


SC2 


DATACOM NSP: MULTIPLE HOST 


SC3 


DATACOM NSP: BLOCKED MESSAGES 


SC4 


DATACOM NSP: EXTENDED MEMORY 


SC5 


DATACOM NSP: DCDLP 


SCSI1 


SMALL COMPUTER SYSTEM INTERFACE DLP 


SCSIDISK 


SMALL COMPUTER SYSTEM INTERFACE DISK (131 
SCSI, 130 SCSI, RESERVED FOR SCSI) 


SCSITAPE 


SMALL COMPUTER SYSTEM INTERFACE TAPE 


SMD1 


STORAGE MODULE DEVICE (226/236/256 DISK 
PACKS) 


TP1 


750/1100/1500 LPM TRAIN PRINTER 


TP2 


B9246-20 2000 LPM BUFFERED PRINTER 


TP3 


B924-B/B924-C 1200/2000 LPM BUFFERED DRUM 
LINE PRINTER 


TP5 


B9246-X AND B924-X BUFFERED PRINTER 


VIM3 


VOICE INTERFACE MODULE-3 
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Output Illustrations 

The following figures illustrate the output for the various LOGANALYZER options 
discussed in this section. Only the first page of the output is shown, so not all the 
examples given are complete. Note that output differs depending on the type of 
hardware being used. 
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Bf A 8JHffS/8JH!!hi%?Hi8j!?'39?8}} U ft!p R jAS RS,0,,: 39 - 023 - 375 ' -^FORMATTER VERSION: 39.023.328. 
ANALYZED BY A15 (SYSTEM SERIAL * 8) ON 64/03/1990 17:39:19 



REQUEST: PRINTER DATE (UNSORTEO BY DEFAULT) 

SUMLOG #000781 CREATED BY A15 (SYSTEM SERIAL » 8) ON 04/03/1990 15:53:36 
TITLE = *SYSTEM/SUML0G ON PACK (CURRENT SUMLOG) . 

FILE CONTAINS 29773 RECORDS FROM 04/03/1990 15:54:00 TO 04/03/1990 17:40:00 



8600 0478-100 



Figure 7-1. DATE Option Output 



7-27 



LOGANALYZER 



L06ANALY ZER VER 
MCP *SYSTEM/MCP 
ANALYZED BY 



VERSION: 39.023.045, SOASUPPORT VERSION: 
MCP/39023G..VERSION: '39,024 (MCP/AS* 
Alb \T 



39.023.375. JOBFORMATTER VERSION: 39.023.328 



(SYSTEM SERIAL * 8) ON 04/04/1590 11:50:21 
REQUEST: PRINTER 1100 TO 1103 ALL (UNSORTED BY DEFAULT) 

fflttvmifttKNB H «gK t ?2SSHgH? E giato5>? > 0N 04/0,/1990 10:55:49 

FILE CONTAINS 22267 RECOROS FROM 04/04/1990 10:56:00 TO 04/04/1990 11:51:00 



Wednesday. April 4. 1990 
ll:00:dl OPEN 2532 



11:00:01 



OPEN 2543 



11:00:01 CLOSE 2532 



11:00:01 CLOSE 2543 



11:00:01 



11:00:01 



OPEN 2532 



OPEN 2543 



EXT NAME: (ALIA)MAIL/NAMESKEY, 
: NAMESKEY . 



INT NAME 

FAMILY NAME: PACK 
FILE ACCESS RULE 



OECLARER (ACTOR 



1DEC1 ARFR 
NO 



DATA 

OPENTYPE: AVAILABLE, POSITION: 6" MOTION: 
FAMILY NAME: PACK 

FILE ACCESS RULE = DECLARER (ACTOR * 

(DECLARER > 
USE « CLOSEO KIN0=PACK FILEKiND 



STACK 09B, JOB 2532. 

STACK 083. JOB 2532 

FILE SliE 27 SEGS 
NONE 



TASK 2543 
TASK 2532 
UNIT NUM 



OPENTYPE: AVAILABLE. POSITiONro; 

hi m ti&j' 1 ™""™- 

FAMILY NAME: PACK 
FILE ACCESS RULE = 



DATA 
MOTION: 



STACK 09B, JOB 
STACK 083. JOB 
FILE S I iE 27 
NONE 



DECLARER 



10 TIME 
CLOSE TYPE: 



(ACTOR = 
(DECLARER 



: 00:00:00.0000 
NORMAL .ASSOCIATION: RELEASE 



STACK 09B. 
STACK 083, 



JOB 
JOB 



2532, 

2532 

SEGS. 



2532. 
2532. 



2543 
1532 



TASK 
TASK 2 
UNIT NUM 



ER 240 



ER 240 



TASK 2543; 
TASK 2532, 



DISPOSITION: REWIND 



PHYSICAL (READ COUNT-1, WRITE COUNT=0) 



90 



TRANSACTION COUNT = 1 
FILE STRUCTURE: ALIGNED180 

» CATEGORY : BUF F ERGOAL. NOT APPLICABLE BUFFERSIZE 

hs;°L «««»■« JK« 8 K, HEi sikVkctou 
ll?'HW? R??i»HMf5Sa E il! E ? ATE 90093 c,clE 1 ,E " S '°" 0 SAV£r,c ™ 

INT NAME: NAMESkEY. 
FAMILY NAME: PACK 
FILE ACCESS RULE 



INTMODE « SINGLE 



OECLARER 



10 TIME 
CLOSE TYPE : 



(ACTOR = 
(DECLARER 



: 00:00:00.0000 
NORMAL .ASSOCIATION: RELEASE 



STACK 09B, 
STACK 083, 



JOB 
JOB 



2532. 
2532, 



TASK 
TASK 



?543 ; 
»532 ; 



DISPOSITION: REWIND 



PHYSICAL (READ C0UNT=1, WRITE COUNT=0) 



90 



TRANSACTION COUNT = 1 
FILE STRUCTURE: AL IGNED180 

ih'A^ ^5 , CATEGORY : BUF FERGOAl. NOT APPLICABLE BUFFERSIZE 
BLOCKSIZE = 90 MI N/MAXRECS I ZE =0/3 

PERM SPEED=00 AREAS1ZE 102 SECTORS FILE SIZE 27 SECTORS 

INT NAME: NAMESKEY. 
FAMILY NAME: PACK 

FILE ACCESS RULE = OECLARER (ACTOR = 



INTMODE » SINGLE 



I DECLARER ~ 
ND = 



OPENTYPE 
EXT NAME: 



AVAILABLE, POSITION: o; 
( ALIA )MA I L /NAMES KEY . 



DATA 
MOTION: 



STACK 09B, JOB 
STACK 083' JOB 
FILE SliE 27 
NONE 



2532, TASK 2543 
2532 TASK 25321 
SEGS . UNIT NUMBER 240 
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Figure 7-2. ALL Option Output 



8600 0478-100 



fc?^§«fIS/X!?H8g^3^?IIi88?-39?85| U fa8?jAn RSI ° N: 39 ° 23 375 - ""FORMATTER VERSIOH: 39.023.328. 
ANALYZED BY A15 (SYSTEM SERIAL - 8) ON 04/04/1990 11:49:01 
REQUEST: PRINTER 1100 TO 1103 RAW (UNSORTEO BY DEFAULT) 

FILE CONTAINS 21656 RECOROS FROM 04/04/1990 10:56:00 TO 04/04/1990 11:50:00 



04/04/1990 11:00:01 
010109E409E4 
O0OOQ020OQOF 
- OOOF 
J805C 
E8000 



.5715 2532/2532 
000000015FEE 



000000400011 
09BQ09E409EF 
D4C5E202C5E8 
O407C1C3D2OO 



. TYPE: 1.5 
0003078402ED 
80001 ICOOOOO 



04/04/1990.11:00:01.5719 



0l0ioiE4O9EF 
00000020000F 



2532/2543 
000000015FEE 



OOOOOOOOOOFO 
0C010108D5C1 
E202CSE8O0OO 



000000400011 
098009E409EF 
D4C5E202C5E8 
0407C1C30200 



- TYPE: 1.5 
000307840376 
B00011COOOOO 
083009E409E4 
1603030404C1 



04/04/1990 11:00:01 
010209E409E4 
00000020001 E 
000000000001 
000000010101 
098009E409EF 
000000000001 



0C01010805C1 
E202C5E80000 



04/04/1990 11:00:01 
Q10209E409EF 



5821 2532/2532 
0000000 15F EE 
000000400020 
000000000000 
000001000000 
083009E409E4 
400000000001 
04C5E20aC5I8 



040i 



30200 



TYPE: 1.6 
0003078414^8 
80001 1C00002 
400000000066 
OOOOOOOQOOOO 
000000100024 
000000000001 
1603030404C1 



00000020001E 
00000000000 I 
000000010101 
09B009E409EF 
000000000001 
0C01010805C1 
E202C5E80000 



5825 2532/ 
000000015FEE 
000000400020 
000000000000 
000001000000 
083009E409E4 
400000000001 
04C5E202C5E8 
0407C1C30200 



2543 TYPE: 1.6 
0003078414S1 
800011C00002 
400000000066 
000000000000 
000000100024 
000000000001 
16030304D4C1 



04/04/1990 11:00:01.6214 

SAxASSISS&S 9Qoogo 

00000020000F 
OOOOOOOOOOFO 



ma 



532 TYPE: 1,5 



OC01010805CI 
E202CSE800O0 



000000400011 

4C " 



09B009E409EF 
04C5E202C5E8 
0407C1C30200 



mam 

083009E409E4 



80 



1603030404C1 



LENGTH: 22 [15 FIXED) 
3C1600010005 OOOOOO0O032A 
000000000000 000000002002 



000000000000 
C9D30404C1C9 



00000010001! 
D308D5C1D4C5 



LENGTH: 22 (15 FIXED) 
3C1600010005 OOOOO00OO32A 
000000000000 000000002002 
000000000000 000000100015 
C9D304D4C1C9 D308D5C104C5 



LENGTH: 37 ( 
782500010006 
000010015FED 
F6F8F2F2F2F0 
000000000000 
000000000000 
000000000000 
C90304D4C1C9 



30 FIXED) 
0OOOOOOOO32A 
005AO000OO03 
000400001000 
OOOOOOOOOOFO 
00000000005A 
000400000000 
D30805C104C5 



LENGTH: 37 ( 
782500010006 
000010015FE0 
F6F8F2F2F2FO 
000000000000 
000000000000 

oooooooooooo 

C9D304D4C1C9 



30 FIXED) 
0OOOOO0O032A 
005A00000003 
000400001000 
OOOOOOOOOOFO 
00000000005A 
000400000000 
D308D5C1D4C5 



LENGTH: 22 (15 FIXED) 



OOOOOO0OO32A 

OOOOOOOOOOOO 00000010001! 
C9D304D4C1C9 D30805C1D4C! 



u.u 



... .0 

NA 

SKEY. . 


...U.. . 
MESKEY . 
. PACK. 


.6.0 
. .MA 


I L I NA i 


l!name 


. . .U. . 




PD. . 






r 


0 

NA 

SKEY. . 


...U.. . 

MESKEY 

.PACK. 


.O.U 
. .MA 


ii'.MAi 


l!name 


. . .U.U 






682220 




! ! .0.' .* 


.■.'.*o:o ; 








! ! ! !na 

SKEY. . 


MESKEY ! 
.PACK. 


: :ma 


i L : MA i 


LiNAME 


. . .U. . 






• • • • i • 


.]:::: 






:!:: 


682220 


'.'.'.ii'.'. 


'.'.'.ii'.ii '. 








!!!!na 

SKEY. . 


MESKEY '. 
.PACK. 


! .MA 


ILiMAi 


l!name 


...u.u 










0 

NA 

SKEY. . 


...U.. . 
MESKEY . 
.PACK. 


. .MA 


i C : MA i 


l.'nahe 



04/04/1 



IBiUtttitt' 



8 ooooooSi?Nl 



543 TYPE: 1.5 
000307848269 



LENGTH: 22 (15 FIXED) 
3C1600010005 00OOOO0OO32A 



.PO.R 



^1 

I 

00 

o 



O 
O 
> 



LOGANALYZER VERSION: 39.023.045, SOASUPPORT VERSION: 39.023.375. 
MCP *SYSTEM/MCP/39023G VERSION: 39,024 (MCP/AST 
ANALYZEO BY A15 (SYSTEM SERIAL * 8} ON 04/04/1990 11:53:13 

REQUEST: PRINTER CONFIG (UNSORTED BY DEFAULT) 

SUMLOG #000786 CREATED BY A15 (SYSTEM SERIAL « 8) ON 04/04/1990 10:55:49 
TITLE » *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 23504 RECOROS FROM 04/04/1990 10:56:00 TO 04/04/1990 11:54:00 
Wednesday. April 4, 1990 



JOBFORMATTER VERSION: 39.023.328. 



3 
m 

30 



00 

c 

r 



o 
o 



o 
o 

o' 

3 

o 

c 

"O 



CO 

cr> 
o 
o 

o 
^1 

f 

I— > 

o 
o 



****************** HARDWARE 

ftAI-r§XSJ EM Hlltfc? 0ftTA PROCESSORS AND 1 10 PROCESSOR , 
HOSTNAME * MPA15C. 

PROCESSOR CONFIGURATION: 
2 PROCESSORS: 



CONFIGURATI 
PARTITION # 1 



0 N 04/04/1990 10:55:49 



************ 



2 CENTRAL PROCESSOR MODULES: 

CPM 4: [ERL* 0B.0,SLL= IF 

CPM 5: [ERL« 0B.0,SLL« 1F.A000.SCL' 



4-5 

1F.A000.SCL' 



O.FEATURES* 
0. FEATURES' 



I/O 



OU 



CONFIGURATION: 
0: 

10000: 
10001: 
10010: 
10011: 
10020: 



BASE 



BASE 



ML I 
ML I 
ML I 
MLI 

ML I .... 
ML I 10021: 
1300: 
HTS2 
HTS2 
MTFIPS1 



2100: 
HTS1 
1100: 
0DT1 
HTS1 
HTS1 
HC2 
2400: 
LSP2 
LSP2 
LSP2 
1200: 
DCDLP 
DCOLP 
NSP3 
2000: 
HC2 
NSP3 
1500: 
LSP2 
LSP2 
BASE 1000: 
TP2 
HTS1 



BASE 



8ASE 



BASE 



BASE 



BASE 



DLP 1304 
OLP 1305 
DLP 1307 

OLP 2104 



OLP 
DLP 
DLP 
OLP 
<NO PATH) 
DLP 118 
OLP 
OLP 



1101 
1104 
1106 
100 



OLP 
DLP 
DLP 

OLP 
DLP 
<N0 PA 



119 
120 

107 
110 
111 

101 
109 



<N0 PATH> 
<N0 PATH> 
<N0 PATH> 



0 PATH> 

St? 11? 



<N0 PATH> 
<N0 PATH> 



DLP 
OLP 



mi 



0 (ALL HEX). CREATION DATE 
0 (ALL HEX). CREATION DATE 



«9/Ii^987j 



09/11/1987] 



FIRMWARE LEVEL: 
BASE 1000 
BASE 1100 
BASE 1200 
BASE 1300 
BASE 2000 
BASE 2100 

FIRMWARE LEVEL: 
FIRMWARE LEVEL: 
FIRMWARE LEVEL: 



SLL=B1,FRL=1.ERL=1 



AD <PATCHED> 
AD <PATCHED> 
0215 



FIRMWARE LEVEL: UC 



FIRMWARE LEVEL: 
FIRMWARE LEVEL: 
FIRMWARE LEVEL: 

FIRMWARE LEVEL: 
FIRMWARE LEVEL: 
FIRMWARE LEVEL: 

FIRMWARE LEVEL: 
FIRMWARE LEVEL: 
FIRMWARE LEVEL: 

FIRMWARE LEVEL: 
FIRMWARE LEVEL: 

FIRMWARE LEVEL: 
FIRMWARE LEVEL: 



UC 
UC 

8502 

01000 10 E 
0100010E 
0100010E 

28.5 
28.5 
15.80 



8502 

15. 7S 



02000201 
0200020E 



FIRMWARE LEVEL: UC 



LOGANALYZER 



- PHYSICAL MEMORY CONFIGURATION 

PROCESSOR #10 

MEMORY MODULE 0 ON PORT 0, 

ADDRESS SELECTION : 0 

SUB_MODULES PRESENT : 0,1 

SUB MODULES ON-LINE : 0,1 (4MW) 

INTERLACING : ENABLED, 2-WAY ADDR2 SUB MOD 0 

MEMORY MODULE 1 ON PORT 2, 

ADDRESS SELECTION : 2 

SUB_MODULES PRESENT : 0,1 

SUB MODULES ON-LINE : 0,1 (4MW) 

INTERLACING : ENABLED, 2-WAY ADDR2 SUB MOD 0 

PROCESSOR #9 

MEMORY MODULE 0 ON PORT 1, 

ADDRESS SELECTION : 1 

SUB_MODULES PRESENT : 0,1 

SUB MODULES ON-LINE : 0,1 (4MW) 

INTERLACING : ENABLED, 2-WAY ADDR2 SUB MOD 0 

MEMORY MODULE 1 ON PORT 3, 

ADDRESS SELECTION : 3 

SUB_MODULES PRESENT : 0,1 

SUB MODULES ON-LINE : 0,1 (4MW) 

INTERLACING : ENABLED, 2-WAY ADDR2 SUB MOD 0 

Figure 7-5. CONFIG Option Output (A 10 Systems) Record 



8600 0478-100 



7-31 



LOGANALYZER 



FAILURE ANALYSIS SUMMARY 



RMM 0 

NON- FATAL FATAL 
CARD : PRIMARY : SECONDARY : PRIMARY : SECONDARY 



IOP 




DTU 




TCPCN 




TCPDT 




TCPTH 




ITC 


: 2 


MICAA 


: 1 


MICDA 


1 


PA 0 


1 


PA 1 




PA 2 


1 


PA 3 




PA 4 




PA 5 




PA 6 




TOTAL 


6 



Figure 7-6. FASUMMARY Option Output 
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8600 0478-100 



LOGANALYZER 



LOGANALYZER VERSION: 39.023.045. SOASUPPORT VERSION: 39.023.037, JOBFORMATTER VERSION: 39.023.328. 

MCP *SYSTEM/MCP/39023G VERSION: 39.024 (MCP/AS ) 

ANALYZEO BY A15 (SYSTEM SERIAL « 822) ON 04/04/1990 12:13:13 

REQUEST: PRINTER HL (UNSORTEO BY OEFAULT) 

SUMLOG #002703 CREATED BY A15 (SYSTEM SERIAL ■ 822) ON 04/04/1990 11:43:19 
TITLE « "SYSTEM/ SUMLOG ON OPERATIONS (CURRENT SUMLOG). 

FILE CONTAINS 22961 RECOROS FROM 04/04/1990 11:43:00 TO 04/04/1990 12:14:00 
Wednesday, April 4, 1990 

SYSTEM 822 HALT LOAOEO 04/04/1990 11:46:09 H/L REASON -MANUAL 
*SYSTEM/MCP/39023G ON DISK, VERSION 3.9.024. (MCP/AS). 

NORMAL TERMINATION FOR LOGANALYZER PROGRAM. 



8600 0478-100 



Figure 7-7. HL Option Output 
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CO 



o 

> 



i3 

m 

70 



LOGANALYZ "R VERSION: 39.022.045, S0ASUPP0RT VERSION: 39.020.035. JOBFORMATTER VERSION: 39.022.324. 

MCP *SYST H/MCP739022C VERSION : 39 .022 (MCP/Asj 

ANALYZED BY A15 (SYSTEM SERIAL « 8) ON 03/14/1990 14:04:03 

3! REQUEST: P /000705 IOSUMMARY (UNSORTEO BY OEFAULT) 

= SUMLOG #000705 CREATEO BY A15 (SYSTEM SERIAL » 8) ON 03/14/1990 09:33:46 

a TITLE * *SUMLOG/8/03149O/0O07OS ON PACK. 

FILE CONTAINS 88014 RECOROS FROM 03/14/1990 09:34:00 TO 03/14/1990 13:47:00 
P° Wednesday, March 14, 1990 

5 I/O ERROR RESULT SUMMARY FOR THE CURRENT LOG ANALYSIS : 

| m m mu »/v m. Si l$WM h?™!*? 

% pack" 73 R 00000 SUCCESSFUL DATA RETRY 53 0 0 

S a * 'A a nflnnn hata frror CORRECTION 4 9 8 



w 4 PACK . 73 R 00000 DATA ERROR CORRECTION 3 n 0 

£ 2 TAPE 28 V 00081 DATA PARITY ERROR 2 fi " 

2 PACK 45 R 00000 SUCCESSFUL DATA RETRY 2 0 

-< 2 PACK 247 R 00000 OATA ERROR CORRECTION 2 § 



0 2 TAPE 31 W 00081 OATA PARITY ERROR £ n 1 
3 Si tit S 8888S KK 8 BS CMUCTtN § 

1 Ifsi IS? S 88888 MK 15588 S885I9S81! 1 § § 



0 

UHIH tsnun Lunntu lun » x S 

DATA ERROR CORRECTION 1 0 0 



O 
c 

T? NORMAL TERMINATION FOR LOGANALYZER PROGRAM. 



00 
CT> 
O 
O 

O 

? 
i — 1 

o 
o 



00 
<T> 
O 

o 
o 

f 

o 
o 



s 

s: 
m 

o 

rf 

5' 
3 

o 

c 

TJ 
C 



^4 

I 

CO 
CP 



LOGANALYZER VERSION: 39.020.040. SDASUPPORT VERSIQA 
MCP *SYSTEM/MCP/39020/DlAG VERSION: 39.020 (MCP/AS) 
ANALYZED BY MicroA (SYSTEM SERIAL * 65535) ON 03/14/ 



k9S A !! A !!!ZER i VER^0N:^39.020 > ,04g i ^ 39.018.034, JOBFORMATTER VERSION: 39.020.314. 

1/1990 14:54:11 



-„ REQUEST: P MAINFRAME (UNSORTEO BY DEFAULT) 

< 2 SUMLOG #000082 CREATED BY MicroA ( SYSTEM SERIAL * 65535) ON 03/14/1990 14:37:16 

5 TITLE » *SYSTEM/SUMLOG ON DISK (CURRENT SUMLOG). 

s,j FILE CONTAINS 967 RECORDS FROM 03/14/1990 14:37:00 TO 03/14/1990 14:55:00 

<0 Wednesday, March 14, 1990 

MAINFRAME ERROR 03/14/1990 14:41:08 EVENT LOGGED AT 14:41:59 
— TYPE * MAINFRAME EVENT 

5 CAUSE « SYSTEM HALT LOADED (INIT) 

> MicroA CONFIGURATION: DATA PROCESSOR-9 

= I/O PROCESSORS 

5 REPORT: 



PROCESSOR 9 H/L REASON: ODT COMMAND 
NORMAL TERMINATION FOR LOGANALYZER PROGRAM . 



o 
o 
> 



m 



LOGANALYZER VERSION: 39.020.040, SOASUPPORT VERSION: 39 018.034 
MCP *SYSTEM/MCP/39020/DIAG VERS ON: 39.020 MCP/AS) 
ANALYZEO BY MicroA (SYSTEM SERIAL » 65535) ON 03/14/1990 14:54:58 

REQUEST: P IOERROR (UNSORTEO BY DEFAULT) 

?V?h? G «*2§?|^l M J§5af§g §N 8il r K°?COR S R Y |!f M S§5fo A G , f.- 65535) ° N "^7:16 
FILE CONTAINS 1034 RECOROS FROM 03/14/1990 14:37:00 TO 03/14/1990 14:56:00 
Wednesday, March 14, 1990 



JOBFORMATTER VERSION: 39.020.314. 



49 



TAPE 
MIX 

320 03/14/1990 



(UNITTYPE-15 DLPTYPE-SCSITAPE . 
„.„ 10 START AREA AREA IOP PATH 

DATE TIME START LENGTH # AOOR 



LOGICAL 
RESULT OESC 



14:39:53 00130300 00018 CHARS 1 



SERIAL 
00010 000008008001 GAD 



FILE 



NEW ERROR CODE = 2E 

SENSE INFORMATION: 0000003C 

ADDITIONAL SENSE DATA: 000000002EOO 



SENSE KEY: BLANK CHECK 
ADDITIONAL SENSE LENGTH: 6 



TAPE STATUS: ? 



RETRY IOP IOP 

CONTROL STATE&RESULT 
, ^ 00408 000000000005 
1 * ,20400 000000000027 

(* INDICATES AN ACTUAL RETRY 



DLP COMMAND 
2750OOOQ000O0000003C0000 



DLP RESULT 



0401 0002 0000 003C 
0401 2000 0000 003C 
TOTAL # OF ACTUAL RETRIES FOR THIS I/O = 



1) 



14:40:07 000928F4 03F4E CHARS 1 00010 O3F4E8008OO1 GAO 



NEW ERROR CODE = 2E 

SENSE INFORMATION: 00003F4E 

ADDITIONAL SENSE DATA: OOOOOOO02E00 



SENSE KEY : BLANK CHECK 
ADDITIONAL SENSE LENGTH: 



TAPE STATUS: < ILLEGAL LENGTH> 



RETRY IOP IOP 

CONTROL STATE&RESULT 

04428 000000000005 

1 * 24420 000000,000027 

(* INDICATES AN ACTUAL RETRY. 



DLP COMMAND 
8050000O0OOOOOOO3F4EOO0O 



OLP RESULT 



0409 0002 0000 3F4E 
C401 0000 0000 0000 
0401 0080 0000 0000 
TOTAL I OF ACTUAL RETRIES FOR THIS I/O = 2) 



I/O ERROR RESULT SUMMARY FOR THE CURRENT LOG ANALYSIS : 

ERROR UNIT LOGICAL RESULT # RECOVERED IN # RECOVERED IN 

COUMT _TYPE_ UNIT! R/W RESULT ANALYSIS «Q 4 ATTEMPTS 

2 TAPE 49 R 08001 TIME LIMIT EXCEEDED 2 0 



IRRECOVERED 
COUNT 



I/O STATISTICS THAT HAVE BEEN ACCUMULATING FOR APPROXIMATELY 3 HOURS AND 27 MINUTES. 



UNIT 
TYPE 



PACK 



UNIT# 

"45" 



1000 BYTES 
TRANSFERRED 

8764" 



R/W 
R 



10 

OPERATIONS 

2999 
1260 



10 
ERRORS 

" 0 
0 



SUCCESSFUL 
H/W RECOVERIES 

0 
0 



fc8^ A 8tVHI8/«!?H88^g 9 v?II i 8S? • 39?8tl u f S8? Ja?? rs 1 0N : 39 020 - 035 ' J08F0RMATTER 39.022.324. 

ANALYZED BY A15 (SYSTEM SERIAL » 8) ON 03/14/1990 14:04:48 
REQUEST: P /00070S 10ERR0R MT (UNSORTED BY DEFAULT) 

!ffi? s .'«8o55585S! 9 8Jo8J5oWSlScI E "" 1 ■ " °" 03/1, ""° 

FILE CONTAINS 88014 RECORDS FROM 03/14/1990 09:34:00 TO 03/14/1990 13:47:00 
Wednesday, March 14, 1990 

TAPE 28 (UNITTYPE»15 0LPTYPE«MTFIPS1) . 

10 START AREA AREA HDD DLP LOGICAL 

MIX DATE TIME START LENGTH I RESULT OESC SERIAL FILE 

3425 03/14/1990 09:38:44 001E0569 0151E CHARS 0 1007 0151E0000081 DABMCP 

EXTENDED RESULT DESC: 0844 089C 0040 2C00 001C 0000 0201 7FC0 9000 00F4 0000 1008 

RETRY HDU CONTROL HDU STATE&RESULT DLP COMMAND DLP RESULT ANALYSIS BY MCP 

1 000000000005 400000000000 0401 1008 0000 0000 DATA PARITY ERROR 

1 4C4.0D OOOOOOQOOOOO IeoIoOoI 000 " ^° ERR0R G REE RESULT 

3 * 48440 400000000000 
(* INDICATES AN ACTUAL RETRY. TOTAL # OF ACTUAL RETRIES FOR THIS 1/0 » 2) 

09:38:59 001E0569 0151E CHARS 0 1007 0151E0000081 OABMCP 

EXTENDED RESULT DESC: 0844 109C 0040 2C00 001C 0000 0202 7FC0 9000 00F4 0000 1008 

RETRY HDU CONTROL HDU STATEiRESULT DLP COMMAND DLP RESULT ANALYSIS BY MCP 

. * 40440 000000000005 400000000000 0401 1008 0000 0000 DATA PARITY ERROR 

1 4C400 000000000000 270200010000 0000 0000 0000 0000 ERROR FREE RESULT 

2 2E0000020000 

3 * 48440 " 400000000000 " " " M 

(* INDICATES AN ACTUAL RETRY. TOTAL # OF ACTUAL RETRIES FOR THIS I/O » 2) 

1/0 ERROR RESULT SUMMARY FOR THE CURRENT LOG ANALYSIS : 

1 TAPE 31 R 00081 UNIT CHECK 0 0 1 



NORMAL TERMINATION FOR L06ANALYZER PROGRAM. 



^1 

I 

00 
00 



O 



C 

»-» 



> 

z 

H 

O 

■o 

o 

3 

o 

c 
•o 



m 
2 

CO 

* 

CD 

3 



LOGANALYZER VI: 
HCP *SYSTEM/M<; 
ANALYZEO BY M 



0.040, SOASUPPORT VERS I 
VERSION: 3S\02^ JMCP/AS 



REQUEST: 



SERIAL * 6553 
P MA I NT (SORTED BY DEFAULT) 



5N: 39.018.034, 
/1990 14:55:32 



JOBFORMATTER VERSION: 39.020.314. 



3 
m 
50 



SUMLOG #000082 CREATED BY MicroA (SYSTEM SERIAL * 65535) ON 03/14/1990 14:37:16 
TITLE « *SVSTEM/SUMLOG ON DISK (CURRENT SUMLOG). 

FILE CONTAINS 1102 RECOROS FROM 03/14/1990 14:37:00 TO 03/14/1990 14:57:00 
Wednesday, March 14, 1990 



49 



TAPE 
MIX 

320 03/14/1990 



(UNITTYPE»15 OLPTYPE«SCSITAPE . 
10 START AREA AREA 
DATE TIME START LENGTH 



I OP 
f 



PATH 
ADDR 



LOGICAL 
RESULT OESC 



14:39:53 001303DD 00018 CHARS 



SERIAL 
00010 000008008001 GAD 



FILE 



00 
CT> 
O 
O 

O 
•£» 
^>J 
00 
I 

i — * 

o 
o 



NEW ERROR CODE » 2E 

SENSE INFORMATION: 0000003C 

ADDITIONAL SENSE OATA: 000000002E00 



SENSE KEY : 
ADDITIONAL 



BLANK CHECK 
SENSE LENGTH: 



TAPE STATUS: ? 



RETRY IOP I0P 

CONTROL STATE&RESULT 
00408 000000000005 
1 * . 2040D 000000000027 

(* INDICATES AN ACTUAL RETRY . 



DLP COMMANO 
275OO0Og00O0000O003,C0000 



DLP RESULT 



0401 0002 0000 003C 
0401 2000 0000 003C 
TOTAL # OF ACTUAL RETRIES FOR THIS I/O » 



1) 



14:40:07 000928F4 03F4E CHARS 1 00010 03F4E8008001 GAD 



NEW ERROR COOE « 2E 

SENSE INFORMATION: 00003F4E 

ADDITIONAL SENSE DATA: OO0OO0002E00 



SENSE KEY: BLANK CHECK 
ADDITIONAL SENSE LENGTH: 



TAPE STATUS: < ILLEGAL LENGTH) 



RETRY IOP 

CONTROL 
04428 
! 2««2D 



IOP 



STATE&RESULT 
000000000005 
000000000027 

INDICATES AN ACTUAL RETRY. 



DLP COMMAND 
8O50OOO0O0000O0O3F4,E000O 



DLP RESULT 



0409 0002 0000 3F4E 

C401 0000 0000 0000 

_ " . m " 0401 0080 0000 0000 

TOTAL I OF ACTUAL RETRIES FOR THIS I/O » 



2) 



# # # # # I # 



UNIT COUNTS. REPORTED FOR 
R/W 



UNIT 
TYPE 


UNIT! 


1000 BYTES 
TRANSFERRED 


PACK 


""4V 


102 


PACK 


45 


8764 


PACK 


47 


811 


TAPE 


49 


7 


OOT 


1 


1382 



i UNITS ON 
10 

OPERATIONS 

..... 

0 

2999 
1260 
137 
4 
11 
3 
48 
1293 



03/14/1990 14:37:17 
10 
ERRORS 



###!### 

SUCCESSFUL 
H/W RECOVERIES 

6 

0 
0 



THE ABOVE COUNTS HAVE BEEN ACCUMULATING FOR 3 HOURS AND 27 MINUTES 



00 
CD 
O 
O 

O 
4* 
vj 
00 

I 

•— » 

o 
o 



LOGANALYZER VER 
MCP *SYSTEM/MCP 



ON: 39.032.052, SOASUPPORT VERSION: 
90320 VERSION: 39,032 (MCP/AS) 
SYSTEM SERIAL - 8) ON 08/03/1990 18:27:59 



39.030.042, JOBFORMATTER VERSION: 39.032.400. 

_ . _ . . w . . , .-w. . "» u j <? 4^ if r n ^ i lira ■ '5 *s n i mi is^ f u i 

ANALYZEO BY A15 

REQUEST: PRINTER MA I NT (SORTED BY DEFAULT) 

mp.'muwm n mjfwadFvtAV. °" Mmn,m 15:40:58 

FILE CONTAINS 36956 RECORDS FROM 08/03/1990 15:41:00 TO 08/03/1990 18:29:00 



Friday, August 3, 1990 



TO 



T 1 



CO 



PACK 
MIX 

7140 08/03/1990 



63 (UNITTYPE«17 SUBTYPE*659 INT 
10 START AREA AREA 
DATE TIME START LENGTH 



DLPTYPE»HTS1). 
HOU DLP LOGICAL 
# RESULT OESC 



16:18:38 00F81554 00A8C WORD 0 



SERIAL 

1104 00A8C0000000 659063 



ROW FILE 



CONTROLWARE ID: E4C3 
DISK OOP STATUS: 4100 
DRIVE STATUS/MESSAGE WORQ 1: 
ERROR DISK ADORESS: 62717 (C 
TEMP R/0: 000000000000 TAG: 



0000 
CYL 46 
0000 



RO: 0080 R/D TAG: 
DISK DDP DIAGNOSTICS: 
DRIVE MESSAGE WORD 2: 
HO 9 SEC 
DRIVE 



■m 

•ssA 



MESSAGE WORD 2: 00000000 



0862 MPM ADORESS: 0000 

0OO09C00 C/D: OP CODE-8 SUB OP-2 VARIANT-0 UNIT- 

0000 # OF RETRIES ON ERROR AODR: 7 

DISK AOORESS FROM COL: 62680 (CYL 46 HO 9 SEC 6) 

iRY *"""•"■ 



RETRY 



HDU CONTROL 
40C30 



HDU STATE&RESULT 
000000000005 



LP COMMAND 
J300000F4D8 



BINARY CYLINDER ADDR: 23 
DLP RESULT 

0401 0080 F400 F4FD SUCCESSFUL DATA RETRY 



O 

■q 



PACK 244 (UNITTYPE«17 SUBTYPE-3682 SEQ 
10 START AREA AREA 
MIX DATE TIME START LENGTH 

9706 



DLPTYPE=HTS2) . 
HDU DLP LOGICAL 
f RESULT DESC 



16:38:52 002AC340 07E90 CHARS 0 



SERIAL ROW FILE 
1305 07E900000000 682244 



O 
C 



99rak W 5?!r. I .9 SilSS r/d TAG: 086 2 CTRL INFO: 
ISI DDP STATUS 1: 0000 ERROR SYMPTOM CODE- 

CONFIGURE INFO : B90C# OF RETRIES ON ERROR AODR: 0 
ERROR DISK AOORESS : 4013560 CYL 1470 HO 2 SEC 96) 
DISK ADDRESS FROM CDL: 4013432 CYL 1470 HD 1 SEC 150) 



0324 

NOT VALID 



SC STATUS 40-43: B940 0000 0000 2130 
C/D: OP CODE-8 SUB OP-0 VARIANT-0 UNIT-4 
TOTAL # OF RETRIES: 0 



o 
c 

* 

ST 
3 

V) 



RETRY 



HOU CONTROL 
40420 



HDU STATEtRESULT DLP COMMAND 
000000000005 8040003D3D78 



********** HARDWARE 
A15 SYSTEM WITH 2 DATA PROCESSORS AND 1 

PROCESSOR CONFIGURATION: 
2 PROCESSORS: 

2 CENTRAL PROCESSOR MODULES: 4-5 

CPM 4: [ERL= OB.O.SLL* 2B.A000.SCL" 0, FEATURES 8 
CPM 5: [ERL 3 0B.O.SLL= 2B.A000,SCL= 0 , FEATURES 3 



DLP RESULT 

0401 0080 F83D 3DF8 DATA ERROR CORRECTION 



CONFIGURATION 
10 PROCESSOR , PARTITION I 



08/03/1990 15:40:58 ********* 



| ALL HEX] 



. ,, CREATION DATE 
[ALL HEX), CREATION DATE 



I/O 



. CONFIGURATION: 
OU 0: 

ML I 10000: 
ML I 10001: 
ML I 10010 



FIRMWARE LEVEL: 
BASE 1000 
BASE 1100 
BASE 1200 



SLL=B2,FRL=1,ERL=1 



08/31/19891 
08/31/1989] 



CO 



LOGANALYZER 



-- CORRECTABLE MEMORY ERROR ACTIVITY -- 

A HARD CORRECTABLE ERROR CAUSED AN ERROR SAMPLING PERIOD TO BE 
INITIATED. 

SAMPLING PERIOD DURATION (MINUTES : SECONDS) : 14:33 

DURING 873 SAMPLES, 255 CORRECTABLE ERRORS WERE DETECTED IN 6 DEVICES. 
ERROR OCCURRENCES BY DEVICE: 
DPM NUMBER CARD NUMBER CHIP ROW CHIP COL PROC NUMBER # OF ERRORS 



3 21 M 

0 17 F 

1 05 K 
0 08 D 

2 17 P 

0 18 F 

1 04 F 



Figure 7-14. MAI NT CPU 



26 09 135 

14 10 103 

07 09 12 

30 10 2 

01 10 1 

26 10 1 

11 09 1 



Option Output (A 10 Systems) 



7-40 



8600 0478-100 



00 

cn 
o 
o 

o 

f 

i — * 
o 
o 



fe?p A 5?SV^iS/^g5i§g^ 2 8 9 V?lii8S?-39?8§i°?S8gjA^I RSION: 39 020 - 035 . ^FORMATTER VERSION: 39.022.324. 
ANALYZED BY A15 (SYSTEM SERIAL * 8) ON 03/14/1990 14:08:51 
REQUEST: P /000705 MA I NT PK (SORTE0 BY DEFAULT) 

FILE CONTAINS 88014 RECORDS FROM 03/14/1990 09:34:00 TO 03/14/1990 13:47:00 
Wednesday, March 14, 1990 



0TQ 
c 

n 
I 

i— » 



A 
o. 

CO 

< 
o 
a 

o 

"O 
i-r 

o 

3 

V 

o 

c 

TJ 
C 



45 (UNITTYPE=17 SUBTYPE»659 INT 
„.„ 10 START AREA AREA 
DATE TIME START LENGTH 



PACK 
MIX 

4356 03/14/1990 



11:55:51 0028B12B 07E90 CHARS 



DLPTYPE=HTS1 ) . 
HDU DLP LOGICAL 
f RESULT DESC SERIAL 

0 1106 07E900000000 659045 



ROW FILE 



4379 



PACK 
MIX 
8259 



C0NTR0LWARE ID: E4C3 RD: 0080 R/D TAG: 

DISK DDP STATUS: 4100 DISK DDP DIAGNOSTICS : 

0RIVE STATUS/MESSAGE WORD 1: ,0000 DRIVE MESSAGE WORD 2: 
ERROR DISK ADDRESS : 1931145 (CYL 1435 HD 11 SEC 80) 
TEMP R/D: 000000000000 TAG: 0000 DRIVE MESSAGE WORD 2: 



0862 MPM ADDRESS: 0000 

00009C0D C/D: OP C0DE-8 SUB OP-0 VARIANT-0 UNIT-1 

0000 f OF RETRIES ON ERROR ADOR: 1 

DISK ADDRESS FROM CDL: 1930972 (CYL 1435 HD 9 SEC 87 
00000000 BINARY CYLINOER ADDR: 717 



RETRY 



HDU CONTROL 
40420 



HDU STATEiRESULT DLP COMMAND DLP RESULT ANALYSIS BY MCP 

000000000005 8010001D76DC 0401 0080 F410 7789 SUCCESSFUL DATA RETRY 



11:59:09 0028B12B 07E90 CHARS 



1106 07E900000000 659045 



CONTROLWARE ID: E4C3 
DISK DDP STATUS: 4100 
DRIVE STATUS/MESSAGE WORD 1: 



0000 



RO: 0080 R/D TAG: 
DISK DDP DIAGNOSTICS: 
DRIVE MESSAGE WQRO 2: 



ERROR DISK ADDRESS: 1931145 (CYL 1435 HO 11 SEC 80, 
TEMP R/D: 000000000000 TAG: 0000 DRIVE MESSAGE WORD 2 



0862 MPM ADDRESS: 0000 

00009COD C/0: OP CODE-8 SUB OP-O VARIANT-0 UNIT-1 

0000 f OF RETRIES ON ERROR AOOR: 2 

DISK ADDRESS FROM CDL: 1930972 (CYL 1435 HO 9 SEC 87) 
00000000 BINARY CYLINDER ADDR: 717 



RETRY 



HDU CONTROL 
40420 



HDU STATE&RESULT DLP COMMAND 
000000000005 8010001D76DC 



DLP RESULT ANALYSIS BY MCP 

0401 0080 F41D 7789 SUCCESSFUL DATA RETRY 



73 (UNITTYPE»17 SUBTYPE=659 INT 
10 S™RT AREA AREA 
DATE TIME START LENGTH 

10:08:09 00C3CA8E 00A8C WORO 



DLPTYPE=HTS1). 
HDU DLP LOGICAL 
# RESULT DESC SERIAL 

0 1104 00A8C0000000 659073 



ROW FILE 



CONTROLWARE 10: E4C3 RO: 0080 R/D TAG: 

OISK OOP STATUS: 4100 OISK OOP DIAGNOSTICS 

ORIVE STATUS/MESSAGE WORD 1: 0000 DRIVE MESSAGE WORD 2: 
ERROR OISK AOORESS: 613929 CYL 456 HO 6 SEC 69) 
TEMP R/0: 000000000000 TAG: 0000 DRIVE MESSAGE WORD 2: 



0862 MPM ADDRESS: 0000 

00009C0D C/D: OP CODE-8 SUB OP- 

0000 # OF RETRIES ON ERROR 

DISK ADDRESS FROM CDL: 613860 (CYL 456 HD 

00000000 BINARY CYLINDER ADDR: 



2 VARIANT-0 
ADDR: 1, 
6 SEC 0) 
228 



UNIT-0 



i— • 



LOGANALYZER VER 
MCP *SYSTEM/MCP 
ANALYZED 8Y A15 



JOBFORMATTER VERSION: 39.022.324. 

SYSTEM SERIAL *~8ToN 63/1^/1^90 14:14:32 
REQUEST: P /000705 0933 TO 0934 BNA USERCOOE. (UNSORTEO BY DEFAULT) 

fV?i:? G » # 2S8^3G585S5!898Jo8Sfo4 S 5g T ^ct ERIAL " 8) ° N "/M/IWO 09:33:46 
FILE CONTAINS 88014 RECORDS FROM 03/14/1990 09:34:00 TO 03/14/1990 13:47:00 



SENO PLM ID TO HOST #296 
PLM-INCARNATION ID: 0OOOO4D233623362 

BSHJS8 CONTROL^FRAME RECEIVED FROM NODE TRENGA #46 
ROUTER LEVEL PRIORITY FRAME TRANSIT COUNT: 1 
1MB Util NET-CHANGE FRAME LENGTH: 14 BYTES 
FRAME : 22010O24O02E0301OO62010206CD 

SEND PLM 10 TO HOST #296 
PLM-INCARNATION ID: 000004D233623362 

SEND PLM ID TO HOST #296 
PLM-INCARNATION ID: 0000040233623362 

ROUTER CONTROL FRAME RECEIVED FROM NODE TRENGA #46 
ROUTER LEVEL PRIORITY FRAME TRANSIT COUNT? 1 
FRAME TYPE: NET-CHANGE FRAME LENGTH: 14 BYTES 
FRAME: 22O10024002EO3O1O1A4O10407CB 
X.25 MCS DEBUG: STACK #08F 9 72355000 

PQ CTERS AGE: CLA$S I7 ' LSN = °* S1ZE = 10 W0RDS> TEXT LENGTH 

ROUTER CONTROL FRAME RECEIVEO FROM NODE TRENGA #46 
ROUTER LEVEL PRIORITY FRAME TRANSIT COUNT: 1 
FRAME TYPE: NET-CHANGE FRAME LENGTH: 14 BYTES 
FRAME : 22O1OO24OO2E03O10ODCO1O4O5C9 

FROM PROGRAM AGENT: HOST 

FROM PROGRAM AGENT: CA 

FROM PROGRAM AGENT: NODE 

SEND PLM ID TO HOST CSDMFG #340 
PLM- INCARNATION ID: 00OOO4D233623362 

RECEIVED PLM ID FROM HOST CSDMFG #340 
REMOTE INCARNATION ID: 000005C4BF4AC200 

SENO PLM ID TO HOST #296 



Wednesday, 


March 


14, 


1990 








03/ !«•/ 


09 


33 


46 . 


7423 


8293 


PLM 


RPT 


m / 1 a / 1 Aon 


09 


33 


■Jo . 


954 1 


8293 


RTR 


CMO 


03/14/1990 


09 


33 


48. 


3929 


8293 


PLM 


RPT 


03/14/1990 


09 


33 


50. 


8916 


8293 


PLM 


RPT 


03/14/1990 


09 


33 


55. 


6507 


8293 


RTR 


CMD 


03/14/1990 


09 


34 


00. 


5773 


8298 


BNA 


RPT 


03/14/1990 


09 


34 


01. 


0112 


8293 


RTR 


CMD 


03/14/1990 


09 


34 


01. 


5092 


8278 


NSM 


RPT 


03/14/1990 


09 


34 


01. 


5278 


8278 


NSM 


RPT 


03/14/1990 


09 


34 


01. 


5366 


8278 


NSM 


RPT 


03/14/1990 


09 


34 


06. 


0775 


8293 


PLM 


RPT 


03/14/1990 


09 


34 


06. 


0806 


8293 


PLM 


RPT 


03/14/1990 


39 


34:06. 


5775 


8293 


PLM 


RPT 



00 
Ov 

o 
o 

o 

p feg^S^?IS/«l??ig8|o?Si8i°v?SSioN? D §iVS§8 R lMg^Sir : 39 018 034 ' J0BF0RHATTER »»sio>: 39.020.314. 

*L. ANALYZED BY MicroA (SYSTEM SERIAL » 65535) ON 03/14/1990 14:56:23 

O REQUEST: P BNAV2 USERC00E. (UNS0RTE0 BY DEFAULT ) 

SUMLOG #000082 CREATED BY MicroA (SYSTEM SERIAL = 65535) ON 03/14/1990 14:37:16 
TITLE = *SYSTEM/SUMLOG ON DISK (CURRENT SUMLOG). 

FILE CONTAINS 1190 RECORDS FROM 03/14/1990 14:37:00 TO 03/14/1990 14:57:00 
Wednesday, March 14, 1990 

03/14/1990 14:44:35.9226 0411 BNAV2 HEADER CONTROL LEVEL = 1 SOURCE HOST * SFB112 

J!t!S H AM ? = 3/14/90. 14:44:34.61 IMMEDIATE LCF HOST = 
S23I5Rt L NG AGENT :0DT AGENT, 6lAL0G# 1 CONTROLLED AGENT: LOCAL NSM 

MESSAGE IS A NW COMMAND 9 CONTROL LEVEL 2 



CD 



NET + 



TO 
C 

m 03/14/1990 14:44:43.2620 0401 BNAV2 HEAOER CONTROL LEVEL = 1 SOURCE HOST = SFB112 

^ SOURCE TIME STAMP « 3/14/90, 14:44:43.20 IMMEDIATE LCF HOST = SFB1 12 

JL MESSAGE IS A LOG REPORT 9 CONTROL LEVEL 1 

■ S,J SU8P0RT OP EN : _PORT 10 5 BY USING PROCESS 0400/0400 FOR PORT INTERNAL NAME NETCONTRO 

t P 1 9 R I.',..U LE J AME = NETCONTROLPORT SUBPORT #1 ENVIRONMENT = HOST-LOCAL (SUBPORT ELEM 
E 9Li N XA R0NMEMT "UMBER = 0) APPLICATION GROUI 1 * *BNA CNTRL AGENT, YOUR HOST = SFB112 

_ YOUR HOST GROUP = SFB112 ACTUAL YOUR USERCODE = . IGNORE DIRECTORY = TRUE AVAILABLE 

g 0 AT Y 3/14/90 ir44-32 R 70 10 * *' Y ° UR SUBP0RT IN0 ^ X * 2 MY USERC0DE s i 0PEN RECEIVE 

< MY NAME = LCF , YOUR NAME = OOT 

CD 

£■ 03/14/1990 14:44:43.3147 0401 BNAV2 HEADER CONTROL LEVEL « 1 SOURCE HOST = SFB112 

§ SOURCE TIME STAMP = 3/14/90, 14:44:43.27 IMMEDIATE LCF HOST = SFB112 

NJ MESSAGE IS A LOG REPORT ? CONTROL LEVEL 1 

■n ?PI P 2 R L OPE ^-r?2 R I„ IO n L T BY USING PROCESS 0011/0011 FOR PORT INTERNAL NAME NWPORT, F 

13. ILE NAME = NETCONTROLPORT SUBPORT #2, ENVIRONMENT = HOST-LOCAL (SUBPORT ELEMENT ENVI 

5' RONMENT NUMBER = 0) APPLICATION GROUI> = *BNA CNTRL AGENT , YOUR HOST = SFB112 YOUR HO 

§ ST GROUP = SFB112 ACTUAL YOUR USERCODE = . IGNORE DIRECTORY = FALSE AVAILABLE ONLY = 

FALSE , YOUR PORT ID = 5, YOUR SUBPORT IN6EX = 1 MY USERCODE = ; OPEN RECEIVED AT 3/ 



O 14/90, 14:44:28.84 

C MY NAME = OOT, YOUR NAME = LCF 

T3 

5- 03/14/1990 14:44:45.4375 0411 BNAV2 HEAOER CONTROL LEVEL = 1 SOURCE HOST = SFB112 

SOURCE TIME STAMP = 3/14/90, 14:44:45.23 IMMEDIATE LCF HOST = 
CONTROLLING AGENT: ODT AGENT. 6lAL0G# 1 CONTROLLED AGENT: LOCAL NSM 

MESSAGE IS A NW POSITIVE RESPONSE 9 CONTROL LEVEL 2 



00 



INITIALIZING NETWORK MOOE WITH NETWORK INITIALIZATION FILE = (SASHA)SFB112/NETINIT/V O 

o 
> 
z 
> 

5 

m 

30 



bS^SVSf EB/SES?$8823a 9 v2Sii 8Sf • 3»?8$i u IB8S Ja?S RS10 " s 39 - 023 - 375 - -^formatter version 

ANALYZED BY A15 (SYSTEM SERIAL « 8) ON 04/03/1990 17:32:23 
REQUEST: PRINTER MCS USERCOOE . (UNSORTEO BY DEFAULT) 

Hftr.'iffiH.-fBKH H ttb , faau , litt«)! > °" 04/0I/1 "° 15:51:36 

FILE CONTAINS 28328 RECOROS FROM 04/03/1990 15:54:00 TO 04/03/1990 17:33:00 
Tuesday. April 3, 1990 



!i!i>,«r"tM , Bi» 



15:58:07 LOGON 5908 



15:58:11 LOGON 5909 



15:59:51 LOGON 5933 



15:59:55 LGOFF 5933 



16:02:24 LGOFF 3199 



16:02:31 LGOFF 3198 



00:00:00.0000 
00:11:37.2129 
196 



SECADMIN 



ORIGINATING LSN: 196 
USERCOOE: WATTON. 
MCS: 1 

STATION NAME: T100B20. 
SIGN OFF BY NORMAL LOG-OFF 
PROCESSOR TIME: 00:00:00.0000 
I/O TIME: " 

ELAPSED TIME: 
ORIGINATING LSN: 
USERCOOE: WOW. 
USERCOOE PRIVILEGE: 
MCS: 1 
CHARGE COOE: 6842. 
STATION NAME: T100B20. 
SIGN ON BY NEW LOG-ON 
ORIGINATING LSN: 546 
USERCOOE: WJW. 

USERCOOE PRIVILEGE: SECADMIN 

CHARGE CODE: 6842. 
STATION NAME: T100B20/CANDE/1 . 
SIGN ON BY NEW LOG-ON 
ORIGINATING LSN: 590 
USERCOOE: RAVENFORO. 

CHARGE COOE: 6715. 
STATION NAME: TB146/ED/1. 
SIGN ON BY NEW LOG-ON 
ORIGINATING LSN: 590 
USERCOOE: RAVENFORD. 
MCS: 2 

CHARGE CODE: 6715. 
STATION NAME: TB146/E0/1. 
SIGN OFF BY NORMAL LOG-OFF 
PROCESSOR TIME: 00:00:00.0479 
i/9»„„ TIME: 00:00:00.0604 
ELAPSED TIME: 00:00:04.4208 
ORIGINATING LSN: 521 
USERCOOE: JULOqUE. 
MCS* 2 

CHARGE COOE: 6842. 
STATION NAME: T100B10/CANDE/1 . 
SIGN OFF BY NORMAL LOG-OFF 
PROCESSOR TIME: 00:00:00.0428 
MV~„- TIHE - 00:00:00.0566 
ELAPSED TIME: 07:34:25.6405 
ORIGINATING LSN: 193 
USERCOOE: JULOQUE . 



LOGANALYZER VERSION 

MCP *SYSTEM/MCP/39023G VERSION: '39 624(MCP/A 
ANALYZEO BY A15 (SYSTEM SERIAL =1) ON 04/O4/I$9O 11:59:36 



G 9 VERSi0N-'39 S ^! U ?S?§J 4 ^ RS,0N; 39 023.375, JOBFORMATTER VERSION: 39.023.328. 



REQUEST: PRINTER NSP USERCODE . (UNSORTED BY DEFAULT) 

ffMVWJIWBHJE H ttb'imfmS)!' 0M 04/04/1990 10:55:49 

FILE CONTAINS 25929 RECORDS FROM 04/04/1990 10:56:00 TO 04/04/1990 12:01:00 



04/04/1990 10:58:11.0049 01 LINE 



04/04/1990 10:58:15.5510 01 LINE 



04/04/1990 11:00:14.0519 01 LINE 



ABORT LSN-000328: 

H±l JS 0 ": 1 ! LINESTATUS-OO; 

no?r 182 ' NOT RDYjFORMA^ERROft/I NPUT- 

ABORT LSN°000328^ " Pt '° 3S '> VAR »A^°°° ' 

RfLT BYTE iNDEX'l; LI NESTATUS=00; 

ABORT E R SN^8S^§ WR ' ' TYPf= ° 35; VAR,ANTa00 ° 
RSL.T BYTE |N0EX = 1: LINESTATUS'OO; 
kO§J.£t AG ' 06 S ERR0R FLAGS'100040- 

ON/LINE NOT ROY. VERTICAL PAR ITY( CHAR ) ; 



04/04/1990 11:16:53.7449 08 MCS INIT Sgi °I k Y g ? gS > J g « 1 1 g ^ 5S 3 3 ^ S V A R 1 A ** T ' ° 6 ° 



NORMAL TERMINATION FOR LOGANALYZER PROGRAM. 



L0GANALY2ER VERSION: 38.82.192, SOASUPPORT VERSION: 38.83.77. 
MCP *SYSTEM/AS0/MCP/OSI/38605A*VERSI0N: 38 .605 (MCP/Ar 
ANALYZED BY A5 SYSTEM SERIAL = 1234) ON OEC 13 1989 



6:30:35 



REQUEST: MIX 9203 DIAGNOSTICS (OSS ( FTAM) ) 

SUMLOG #001596 CREATED BY A5 (SYSTEM SERIAL = 1234) ON OEC 13, 1989 06:22:25 
TITLE = *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 13243 RECORDS FROM DEC 13, 1989 06:22 TO OEC 13, 1989 06:31 



OEC 13. 

12/13/^9 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 

12/13/89 



1989 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25; 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 
06:25: 



12/13/89 
12/13/89 
12/13/89 
12/13/89 
12/13/89 
12/13/89 
12/13/89 
12/13/89 
12/13/89 
12/13/89 

! 

12/13/89 

mm 




55.261 
55.264 
55.267 
55.270 
55.273 
55.309 
55.498 
56.057 
56.061 
56.069 
56.072 
56.136 
56.142 
56.145 
56.171 
56.176 
56.179 
55.204 
55 . 209 
55.213 
56.238 
56.243 
5(5.307 
5(5.435 
56.535 
56.838 



57.221 
27.186 
27.351 
27.357 
27.362 
27.365 
27.370 
27.374 
27.377 
7.382 
7.387 
7.390 
7.394 

m 



9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 



9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 


9203 


DSS 


FTAM 


9203 


OSS 


FTAM 



-40866620: 
-40866720: 
-40866780: 
-40866880: 
•40866980: 
-40882240: 
-40882240: 
-48378026: 
■48378430: 
-48378672: 
-48378682: 
-48378360: 
-48378672: 
-48378682: 
-48378290: 
-48378672: 
-48378682: 
-48378220: 
-48378672: 
-48378682: 
-48378150: 
-48378672: 
-48378682: 
-55813450: 
-44606000: 
-41739500 



FILE XFER -• 



FILE XFER -• 



LOCAL VOLUME ATTRIBUTES 
FAMILYNAME = DISK . 

REMOTE VOLUME ATTRIBUTES 
USERCOOE = JASMITH/DOC. 
YOURHOST » MPA3BC. 
FILE XFER -- SESSION - 0, NEXT ACTION 
~ SESSION = 0> NEXT ACTION 



7, LAST CONDITION 
- 8. LAST CONDITION 
0 8571 1 1. 
ISO FTAM PCI 



624 
624 



FILE XFER -■ .,.„„..„„ ... 
PROPOSING APPLICATION CONTEXT 
PROPOSING PRESENTATION CONTEXT 
CONTEXT- ID * 3 
CONTEXT = 1 0 8571 2 1. 
PROPOSING PRESENTATION CONTEXT 
CONTEXT-IO = 5 
CONTEXT » 1 0 8571 2 2. 
PROPOSING PRESENTATION CONTEXT 
CONTEXT-IO * 7 
CONTEXT * 1 0 8571 2 3. 
PROPOSING PRESENTATION CONTEXT = ISO UNSTRUCTURED BINARY 
CONTEXT-IO » 9 
CONTEXT * 1 0 8571 2 4. 
PROPOSING PRESENTATION CONTEXT 
CONTEXT-IO = 11 
CONTEXT * 1 3 9999 1 2 2. 
WINSTON INITIATOR SESSION = 1, STATE = 1, EVENT * 408 
NEVILLE-INITIATOR -- SESSION = 1 STATE * l! EVENT » 1008,, STEP * 1 
LENGTH * 158 OCTETS : TEXT TO BE SENT WITH THE OPEN STATEMENT 



ISO FTAM FAOU 



ISO UNSTRUCTURED TEXT 



NBS FILE DIRECTORY 



00000 
00036 
00072 
00108 
00144 



IqIoISISIISI S^IffS?!?!? S8§5fS?i? 2 c I5 41205345524? 45532046544 



'05068617365 
'1528 



0580860100A7 80400528C27B 0201400528C2 7BO2O24O01-. „„»,„^.,.. 
813SSS2!8382 3§8§g§S§SS8S §^° 528C27B O5O1O0 °O56O9 4 2 4541554348 414050718019 



--55571940 
--55571940 
--36469014 
--36472554 
--36472674 
--36472686 
--36472474 
--36472674 
--36472686 
--36472394 
--36472674 
--36472686 
--36472314 
--36472674 
--36472686 



FILESTATE 
FILESTATE 



CHANGED: 
1 0 857i 1 1 
* ISO FTAM PCI 



ISO FTAM FAOU 



THE STATE OF THE PORT FILE HAS CHANGED; 

THE STATE OF THE PORT FILE HAS ' 

CHECKING APPLICATION CONTEXT * 
ACCEPTING PRESENTATION CONTEXT 

CONTEXT-ID * 3 

CONTEXT = 1 0 8571 2 1 
ACCEPTING PRESENTATION CONTEXT 

CONTEXT-ID = 5 

CONTEXT * 1 0 8571 2 2 
ACCEPTING PRESENTATION CONTEXT 

CONTEXT-IO » 7 

CONTEXT » 1 0 8571 2 3 
ACCEPTING PRESENTATION CONTEXT * ISO UNSTRUCTURED BINARY 

CONTEXT- ID * 9 

CONTEXT = 1 0 8571 2 4 



(OFFERED) 
(OPENED) 



ISO UNSTRUCTURED TEXT 



00 

o 
o 

o 
oo 



o 
o 



on 
c 

CD 



> 
ff> 

o 

CO 
H 

8 

X 

CO 

o 

■a 
»-»■ 

o' 

o 

c 
i-f 
■a 



ANALYZED BY A6 (SYSTEM SERIAL - 470) ON DEC 15. 1989 19:25:45 
REQUEST: PRINTER 1725 TO 1726 DIAGNOSTICS (MHS) UNSORTED 

fVftP. # «WHW!5«a 11 ^ci s TaS^E^ R ISfcL5G? 70> 0M DEC 15 - 1989 17:20:40 

FILE CONTAINS 77709 RECOROS FROM DEC 15. 1989 17:20 TO DEC 15. 1989 19:26 



DEC 15. 1989 
12/15/69 17 


25:01.375 


o i in 
SI 30 


MHS 


RTS 


12/15/89 


17 


25:01.383' 


9130 


MHS 


RTS 


12/15/89 


17 


25:01.400 


9134 


MHS 


RTS 


12/15/89 


17 


25:01.472 


9135 


MHS 


RTS 


12/15/89 


17 


25:01.486 


9136 


MHS 


RTS 


12/15/89 


17 


25:01.564 


9134 


MHS 


RTS 


12/15/89 


17 


25:01.599 


9135 


MHS 


RTS 


12/15/89 


17 


25:01.612 


9136 


MHS 


RTS 


12/15/89 


17 


25:01.667 


9134 


MHS 


RTS 


12/15/89 


17 


25:01.743 


9135 


MHS 


RTS 


12/15/89 


17 


25:01.764 


9134 


MHS 


RTS 


12/15/89 


17 


25:01.799 


9135 


MHS 


RTS 


12/15/89 


17:25:01.810 


9136 


MHS 


RTS 


12/15/89 


17 


25:01.863 


9134 


MHS 


RTS 


12/15/89 


17 


25:01.910 


9135 


MHS 


RTS 


12/15/89 


17 


25:01.917 


9136 


MHS 


RTS 


12/15/89 


17 


25:01.989 


9136 


MHS 


RTS 


12/15/89 


17:25:02.046 


9131 


MHS 


RTS 


12/15/89 


17 


25:02.054 


9134 


MHS 


RTS 


12/15/89 


17 


25:02.128 


9135 


MHS 


RTS 


12/15/89 


17 


25:02.136 


9136 


MHS 


RTS 


12/15/89 


17 


25:02.191 


9134 


MHS 


RTS 


12/15/89 


17 


25:02.236 


9135 


MHS 


RTS 



Adding request to queue - entry * 
MTA Assoc * 2 Buffer « 1048575 LengEh 



RT TRANSFER REQUEST over MTA assoc 
Transfer Time » 10 RTS assoc « 1 
S ACTIVITY START REQUEST for BNA p.. 
Activity 10 * [02 JU) 1 
Adding request to queue - entry * 1 
MTA Assoc - 0 Buffer. ?.0 Length 



Queue Type 
" Par 



0 'Params ■ 10485Z5 
message (M)[ f 
Result * 0 8 

t [2] Result = 0 Connection ■ 45 
1 Function Type « 
1 MTA assoc 



Function Type 
2 for message {M)[ 1*94 ][U»330] 




Queue Type « 
12 Params ■ 1 

RTS assoc 

onnectlon 



Snath"* 1024 Text « l234B6?8§0i2MS6?89OiO458789O12345o789O. . . ' 
Adding request to queue - entry * 7 .Queue Type » 1 Function Type « 
MTA Alsoc » 0 Buffer « 0 Length * 1030 Params - 1 JV 
Message from BNA port [2] Connection * 45 RTS ass 
Data - length » 1030 

L?!!! c ..MlN0RJtEQUEST for BNA port [2 J Result » 0 Con 

ntry « 1 

8 

y » 4 
gth * 1 
LZJ Connectio 
SyncPoInt - \ 



Connection * 45 RTS assoc » 1 MTA assoc « 0 



SyncPoTnt 
Adding request to queue 
MTA Assoc *_0 .Buffer ■ 2 
AT* " 
gt 
Adain 



Queue Type 
12 Params 



S DATA REQUEST for BNA port [2]'Resu1t = 0 Connection 

'5678901234567890123456789012345678901234. 



LCnqth 

ig request to q 
MTA Alsoc = 0 Buffer 



1024 Text 
request to 



Connection * 45 
1 Function Type 
45 



ueue - entry * 4 
1 Length 



Message from BNA port [21 Connection 
c Minor Request SyncPoInt ■ 1 , , 

REQUEST Tor BNA port [2] Result 



Sync Minor Request 
S SYNC MINOR 
SVncPoTnt - Z 
A 

MTA Assoc '» 0 B 



\dd1ng request to queue - entry = 7 
UA Assoc » 0 Buffer * 2 Length * 1 
S SYNC MINOR RESPONSE for BNA port [2] 



SyncPoTnt = t 
Message from BNA port [2] 
Oata_-_length » 1030 



Length 
IA port 

Connection 



45 



0 Connection = 45 

1 Function Type ■ 
45 

RTS assoc = 1 MTA assoc 



?ueue Type * 
Params * 1 
Result - 0 Connection 



62 



59 



ueue Type « 1 Function Type 
30 Params - 2 1Y 
- 45 RTS assoc » 1 MTA assoc 



59 



Function Type = 60 



'??????567890123456789O123456789O123456789O12345678' 
Adding request to queue - entry * 2 Queue Type * 1 
, M JA A *52 C = 2 Buffer = 3 Length « 12 Params = 1 
S DATA REQUEST for BNA port [2] Result « 0 Connection * 45 
Lfngth-= 1024 Text = , 9012345678901234567890123456789012345678. . . ' 
Adding request to queue - entry » 1 Queue Type = 1 Function Type = 
MTA Assoc = 0 Buffer =3 Length = 1030 Params =2 



... ... . jrams = _ 

Message from BNA port [21 Connection = 45 RTS assoc = 1 MTA assoc 
Sync Minor Request SyncPoInt = 2 , , 

S SYNC MI NOR REQUEST for BNA port [2] Result = 0 Connection = 45 
SyncPoTnt = 3 

Adding request to queue - entry = 4 Queue Type = 1 Function Type 
MTA Assoc = 0 Buffer = 1 Length = 12 Params « 1 3 



59 



LOGANAIYZER VERSION: 39.609.706. SOASUPPORT VERSION: ,39.25.41 , 
MCP *SYSTEM/AS0/MCP/39026/0iAGNdSTICS YERSION: 39.26 (MCP/AS) 
ANALYZEO BY A3 (SYSTEM SERIAL * 2356) ON JUL 11. 1990 15:16:03 



REQUEST : P DIAGNOSTICS (NIS) UNSORTEO 

SUMLOG #001622 CREATED BY A3 (SYSTEM SERIAL * 2356) ON JUL 11, 1990 15:03:30 
TITLE » *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 455 RECORDS FROM JUL 11, 1990 15:04 TO JUL 11, 1990 15:17 



JUL 11. 

15:10:43 

15:10:43 

15:10:43 

15:10:43 

* 0 CHAR 

15:10:43 

15:10:55 

15:10:55 

15:10:55 

15:10:55 

15:10:55 

15:10:55 



1990 
.1378 
.2808 
.3356 
.3703 
LEN » 
.3834 
.4782 
.4915 
.5087 
.5222 
.5361 
.5505 



DI AG 1907 NIS NS 
OIAG 1907 NIS NS 
DIAG 1907 NIS TOKEN 
DIAG 1907 NIS TOKEN 
1 CHARS REM » -1 
OIAG 1907 NIS NS 



DIAG 1907 
DIAG 1907 
OIAG 1907 
DIAG 1907 
OIAG 1907 
DIAG 1907 



NIS NS 
NIS NS 
NIS NS 
NIS NS 
NIS NS 
NIS NS 



20004070 - NS SERVANT SENDMESSAGE MSG LEN IS 54 
82246000 - PARSE COMMAND - COMMAND PARSED SUCCESSFULLY 
AFTER SHIFT. BUFFER IS: "" 

TOKENGETNEXT - FOUND TOKEN: N CLASS = 8 TOKEN = 8 VALUE 
82248400 - PARSE COMMAND END 

45161000 - NETWORK SUPPORT - INPUT EVENT OCCURRED 
40570000 - F1NDNWMCSSAGE - BEGIN 
40237000 - REMOVE PACONTROLINFO - BEGIN 
40408000 - REMOVE'PACONTROL INFO - REPORT 
40514000 - REMOVE-PACONTROLINFO - END 
40616000 - FINONWMESSAGE - END 



NORMAL TERMINATION FOR LOGANALYZER PROGRAM . 



fe8^ A 2§VlfIS/«!g?|§gi3a 9 V?§ii8S?-39t85| U IS8?JA?r S,0,i: 39 0 »- 375 . """FORMATTER VERSION: 39.023.328. 
ANALYZED BY A15 (SYSTEM SERIAL * 8) ON 04/03/1990 17:34:04 
REQUEST: PRINTER ABORT USERCOOE . 

SUMLOG #000781 CREATED BY A15 (SYSTEM SERIAL =.8} ON 04/03/1990 15:53:36 
TITLE * *SYSTEM/SUML0G ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 28804 RECORDS FROM 04/03/1990 15:54:00 TO 04/03/1990 17:35:00 



Tuesday. Aprl 
17:29:44 



1990 
3193 



17:29:44 CLOSE 3193 



17:29:44 CLOSE 3193 



17:29:44 CLOSE 3193 



17:29:44 CLOSE 3193 



DECLARER = STACK AFF, JOB 3191, TASK 3193! 

«E DISPOSITION: REWIND 
(READ COUNT=0 , WRITE COUNT=0) 



*BUFFER$IZE: 



0/ 2560 



INTMODE = EBCDIC 



*OBJECT/ED ON MCPMAST. 
STACK NUM8ER: OAFF 
TASK TYPE: DEPENDENT TASK (PROCESS) 
USERCOOE : POLTON. 
CHARGECOOE: 6692. 
MCS NUMBER: 2 LSN NUMBER: 519 
MCS NAME: SYSTEM/CANDE . 
TIMESTAMP: 08:25:38 
EXT NAME: REM. 
INT NAME: REM. 

FILE ACCESS RULE = DECLARER (ACTOR 
10 TIME : 00:00:00.0000 

CLOSE TYPE: NORMAL ASSOCIATION: RELEA5 
TRANSACTION COUNT = 40 PHYSICAL 
5M^E§5 .CATEGORYz BUFFERGOAL NOT APPLICABLE 
BLOCKSIZE » 2560 MIN/MAXRECSIZE 
f XT NAME: *XREFMLES/SYSTEM/PR I NT/ SUPPORT/DECS • 
INT NAME: DECLARATIONS. 
FAMILY NAME: SYS37 

^.ACCESS RULE "DECLARER (ACTOR - DECLARER = STACK AFF, JOB 3191, TASK 3193) 
lu lint : OU : 00 : UO . 5 55 1 

Sk2SI.J??Si MS 1 ASSOCIATION: RELEASE DISPOSITION: BLOCKEX IT . 
f?l!f S ^u2?U^?lL?G^D180 PHYSICAL C0UN ™ 5 ' WRITE C ° UNT * 0) 

BLOCKS I ZE^ G ^" = : 5 1 0 F F E RGO AL NOT APPLICABLE BUFFERSIZE: 510 
PERM SPEEO=00 AREASIZE 255 SECTORS FILE SIZE 3808 SECTORS 

INT NAME: REFERENCES. 
FAMILY NAME: SYS37 

FILEjACCESS RULE = o OECLAR|R (ACTOR = DECLARER = STACK AFF, JOB 3191, TASK 3193) 
CLOSE TYPE: NORMAL " ASSOCIATION: RELEASE DISPOSITION: BLOCKEXIT 
f?K S S?R T U?M?^lLlGN?D180 PHYSICAL ?READ COUNT=23, WRITE COUNTED) 
BUFFER CATEGORY: BUFFERGOAL NOT APPLICABLE BUFFERSIZE: 210 
? SeEO-oS "XrE.SIIC no"JE« E "JfE E S.hWsECTO.S """°° E 

a?'aj? nmnmMv 85234 c,ciE 1 nR5 " m 0 sA,Ef * c ™ 0 

INT NAME: SYMBOL. 
FAMILY NAME: SYS38 

FILE ACCESS RULE « DECLARER (ACTOR 
10 TIME : 00:00:00.8348 

Sk?SI.J??5fi 52RM L ASSOCIATION: RELEASE DISPOSITION: BLOCKEXIT 
f?f? S ??R T u2?UR C ^ N JLlG??§180 PHVS,CAL COUNT=43 ' WR,TE C0UNT=0) 



SINGLE 



SINGLE 



DECLARER = STACK AFF, JOB 3191. TASK 3193) 



I 

tn 
o 



fe8^ A ^VIIiS/S!??|?g^3g 9 V?iIi83?*39t8ti U J58^A^ RSION: 39 023 - 375 ' ^FORMATTER VERSION: 39.023.328. 
ANALYZED BY A15 (SYSTEM SERIAL * 8} ON 04/03/1990 17:40:21 

REQUEST: PRINTER 1500 TO 1630 BOJ USERCODE . (UNSORTED BY OEFAULT) 

???t?V2??J?WSuAfo : 8 li M!K ( ?ffi N ? ER suSI:oa, 8) 0N °< m/mo 15:53:36 

FILE CONTAINS 30049 RECORDS FROM 04/03/1990 15:54:00 TO 04/03/1990 17:41:00 
Tuesdai 



ssday. April 3. 1990 

15:53:36 BOJ 5875 "UPDATE FAULTLOG" . 



STACK NUMBER : 030B 
QUEUE: 0 
ORIGINATING UNIT: 0 
PRIORITY: 80 

■n ic c, SCHEOULED FOR: 00:00:08.0400 

,=;• 15:53:37 BOJ 5878 "BEGIN JOB:RUN SYS" . 

<J2 STACK NUMBER : 03DE 

| QUEUE- T 0 RED SVSTEM: 04 /° 3 /1990 15:53:37 FROM WFL 39.23 

v| ORIGINATING UNIT: 0 

^ 15:54:19 BOJ 5807 HOSTCOMphS? 

±k STACK NUMBER: 03E6 

QUEUp T 30 E ° SYSTEM: 04 /° 3 /199° 15:43:20 FROM WFL 39.23 
— ORIGINATING LSN: 562 MCS: 2 

2 PRIORITY: 40 

O USERCODE: ALES HA; 

CHARGECODE: 6893. 

O SOURCENAME : SFA6AB/TB117/CANDE/1/CANDE/1 . 

"O , e ,„ , INITIATING MCS: SYSTEM/CANOE. 

ET. 15:54:19 BOJ 5883 SERVER/LP5. 
O STACK NUMBER: 03EA 

= QUEUE: 0 

O ORIGINATING UNIT: 0 

c , F ,~ PRIORITY: 80 

«■ 15:54:39 BOJ 5886 *SYSTEM/IGS0ASUPP0RT. 
"2 STACK NUMBER: 03F0 

s _ iWMW-?llLM 1990 22:43:21 BY DCALG0L 3923 

QUEUE: 0 

ORIGINATING LSN: 560 MCS : 2 
PRIORITY: 50 
USERCODE: DBH. 
CHARGECOOE: 6685. 
SOURCENAME: TB 1 3 IS 1 /CANOE/ 1 . 
mm . INITIATING MCS: SYSTEM/CANDE . 

15:54:39 BOJ 5887 (00B8)0BJECT/UTI l/RUNPMTR ON PACK . 
§0 STACK NUM8ER: 03F1 

& CODE COMPILED: 03/23/1990 14:47:23 BY ALGOL 38.93 

y QUEUE: 0 

O ORIGINATING LSN: 295 MCS: 1 

O PRIORITY: 50 

^ USERCOOE: JEFF. 

53 CHARGECODE: 6381. 

Co SOURCENAME: TB137. 

T INITIATING MCS: *SY5TEM/COMS . 

f— » 

O 

o 



00 
G) 
O 
O 

O 

F fc8g A »g»fia/«???J88^3g%?iii8S?-39f8§| U fS8gJA?! RSION: 39023 - 375 ' ^FORMATTER VERSION: 39.023.328, 

h- ANALY2E0 BY A15 (SYSTEM SERIAL * I) ON 04/03/1990 17:44:42 

O REQUEST: PRINTER 1500 TO 1630 BOT USERCODE . (UNSORTEO BY DEFAULT) 

mrsmsfosmi a ^i&'Ah'J m 0,/03 ' 19So 15:53:36 

FILE CONTAINS 30865 RECOROS FROM 04/03/1990 15:54:00 TO 04/03/1990 17:46:00 

Tuesday, Aorll 3, 1990 

15:53:36 BOJ 5875 "UPDATE FAULTLOG" . 

STACK NOMBER: 030B 
QUEUE : 0 

ORIGINATING UNIT: 0 
PRIORITY: 80 

,r r, ,, «.», SCHEOULED FOR: 00:00:08.0400 

15:53:37 BOJ 5878 BEGIN JOBtRUN SYS" . 

STACK NUMBER: 030E 

■n QUEUE* 1 "" SYSTEM: 04 /° 3 /1990 15:53:37 FROM WFL 39.23 

TO ORIGINATING UNIT: 0 

= ic e, „„ T ,.„,„ PRIORITY: 50 

3 15:53:37 BOT 5879 JSYSTE^FAULTLOGGER . 

2 ?8S ! L E8^o8?(S?(iI?e , 13 : 55 : 08 BY DCALGOL 39.23 

15:54:17 BOT 5880 SYSTEM/STAXFER/0IAL0GINIT/16. 

STACK NUMBER: 03E3 

00 PRIORlTY E: 75 EPtN ° ENT TASK ( pR0CESS > 

9 15:54:18 BOT 5881 JOBOECT^FLMSG^N MCPMAST. 

4? mi MPlUoiWMlll) 12 '-*'-- 1 ' 8Y 0CALGOL 3873 

5? PRIORITY: 40 ' 

§ USERCOOE: FUJIYAMA. 

O 1S:S4:1<I BOJ 5807 SoW?!," 15 ' 

c STACK NUMBER: 03E6 

■S" QUEUE NT 30 E ° SYSTEM: 04 /03/1990 15:43:20 FROM WFL 39.23 

s niut??!V M! 562 " cs: 2 

USERCOOE: NARAYANA. 
CHARGECOOE: 6893 



I 

Ol 



*SYSTEM/PATCH ON SYS39. 



15:54:19 BOT 5882 *SYSTEM/PATCH ON SYS39. 

STACK NUMBER: 03E8 



K!E 5???!. L c§io8l(l!{c??? ) 16:52: '" " AlMl 35 23 o 



?S???ffiSi : ' N c^ 3 5?^!«c«SE OE " /c *'" ,E/1 - 



F3 

m 

73 



CJ1 
N> 



o 
o 
> 



ore 
c 
— « 

vl 



</> 
O 



O 
c 



00 

en 
o 
o 

o 
-i^ 
vi 

i— » 
o 
o 



LOGANALYZER VERSION: 39.023.045, S0ASUPPORT VERSION: 39.023.037. 
MCP *SYSTEM/MCP/39023G VERSION : 39 .024 (MCP/AS) ' 
ANALYZED BY A15 (SYSTEM SERIAL = 822) ON 04/05/1990 10:23:33 

REQUEST: PRINTER 0MS USERC00E . (UNS0RTE0 BY DEFAULT) 

SUML0G #002710 CREATED BY A15 (SYSTEM SERIAL = 822) ON 04/05/1990 07:00:41 
TITLE = *SYSTEM/SUML0G ON OPERATIONS (CURRENT SUMLOG). /U3/i:,! ' u 

FILE CONTAINS 58258 RECOROS FROM 04/05/1990 07:01:00 TO 04/05/1990 10:25:00 



JOBFORMATTER VERSION: 39.023.328. 



3 
m 

2J 



Thursda 
08:5 



v , April 5. 
8:40 DM$ 



1990 
2557 



08:58:42 



08:58:49 



08:58:50 



09:01:50 



09:02 : 09 



09:021: 11 



QMS 2519 



08:58:43 OMS 2521 



OMS 2513 



OMS 2517 



OMS 



OMS 



2625 
2391 



DMS 2624 



(JACQUE)EBBDB. (STACK ICO) 
DATABASE FROZEN. 

ACR^NANE : *SYSTEM/ACCESSROUTINES. 
*SYSTEM/SIM/DMSIISUPPORT ON SYS39. 
OPEN OATABASE. 
USERCOOE 
OATABASE NAME 
INTERNAL NAME 
OPEN TYPE 
SIB LEVEL 

TE LEVEL 
EB80B/1/2500 
OATABASE. 
USERCOOE 
DATABASE NAME 
INTERNAL NAME 
OPEN TYPE 
SIB LEVEL 



SID U 

UPOATf 
(IOF)I 
OPEN t 



(STACK 2FB) 



WBW 

JJACQUE)EBBDB. (2557/2557, STACK ICO) 
10' 

08 , ACR LEVEL : 060 

004 , LOGICAL DB NUMBER : 000 



UPDATE LEVEL . 
*SYSTEM/SIM/DMSIISUPP6rT ON SYS39 



WBW 

^JACQUE)EBBDB 

12" 

08 , ACR LEVEL 
004 , LOGICAL OB NUMBER 



(2557/2557, STACK 1CD) 



060 
000 



OPEN DATABASE 
USERCOOE 
OATABASE NAME 
INTERNAL NAME 
OPEN TYPE 
SIB LEVEL 
UPDATE LEVEL 
OPEN FAILED . ........ 

(JACQUE)EBBDB/l/2480 

Open oatabase 



OACOUE. 
( JACQUE )ebbdb 

10' 

08 , ACR LEVEL 
. 004 . LOGICAL DB NUMBER 

ERROR #64 



(2557/2557, STACK 1CD) 



060 
000 



USERCOOE 
OATABASE NAME 
INTERNAL NAME 
OPEN TYPE 
SIB LEVEL 
UPOATE LEVEL 



JACQUE. 

(JACqUE)EBBOB. (2557/2557, STACK 1CD) 
12' 

08 , ACR LEVEL : 060 

QQ4 , LOGICAL DB NUMBER : 000 



(OF)X. (STACK 225} 
DATABASE FROZEN. 
A . C ? T !!! A M E x : (9F)SYSTEM/ACCESSR0UTINES. 
(WATKINS)AO0S08/2/2385. 
CLOSE OATABASE. 



(STACK 226) 



USERCOOE : WATKINS . 

OATABASE NAME : (ADOSPATCH)ADDSOB . 

LOSE TYPE : 0 

QF)OBJECT/UP/X/DKTEST ON OMSII. 

LOSE DATABASE. 
USERCOOE : OF. 

DATABASE NAME : (QF)X. (2625/2625, 



(2218/2218, STACK EFB) 



STACK 225) 



LOGAMAL YZER VER 
MCP *SYSTEM/MCP 
ANALYZEO BY A15 



5 I 



8!!i^ 9 «22ii22?',« s 8 A § u ?£28Lyf RS,ON: 39.023.375, jobformatter version: 39.023.32a, 

10 



90236 VERSION : "39702<I"(MCP/AS X 
SYSTEM SERIAL • 8} ON &4/03/l§90 17:59 



REQUEST: PRINTER 1500 TO 1630 EOJ USERCOOE . (UNSORTEO BY DEFAULT) 

?V?!:?V8§?m«g H « f S6SI^ H ? e ififtE:o5 J " 0,/03 ""° 15:53:56 

FILE CONTAINS 33029 RECOROS FROM 04/03/1990 15:54:00 TO 04/03/1990 18:00:00 



Tue 



15:53:38 



Ml 



loo 19 ! 5 



875 



EOJ 5878 



15:54:18 EOJ 5663 



15:54:38 EOJ 5846 



15:55:01 



EOJ 5886 



"UPDATE FAULTLOG". 
STACK NUMBER: 03DB 
PROCESSOR TIME: 00:00 
TIME: 00:00 
TIME: 00:00 
TIME : 00:00 
TIME: 00:00 



I/O 
REAOYQ 
INITPBIT 
ELAPSED 



BEGIN J08.RUN SYS". 
STACK NUMBER : 030E 
PROCESSOR TIME: 00:00 
I/O.. TIME: 00:00 

READYO TIME: 00:00: 
INITPBIT TIME: 00:00: 
OTHERPBIT TIME: 00:00: 
ELAPSEO TIME: 00:00: 



- «.„.. AVERAGE MEMORY USAGE : CODE»0, DATA«740 

88 :8I^i TST?^ 1 ^!! f 5^ L ii CO0K "° ■ 000 • 0ATA ' 0 - 051 

22 -22?2 MAXIMUM NUMBER OF'ASDS USEO: 5. 
00.0035 MAXIMUM SAVE MEMORY USED: 696. 
00.1165 

„„ AVERAGE MEMORY USAGE: CO0E*77. DATA»1086 

00.0347 MEMORY INTEGRAL: CODE«0.009, 6ATA*0.132 
00.0865 INITIAL PBITS: 16, OTHER PB TS: 1. 
00.0074 MAXIMUM NUMBER OF ASDS USED: 5. 
00.0087 MAXIMUM SAVE MEMORY USEO: 2127. 
00.0013 
00.8176 



SASHA373MCP. 

STACK NUMBER: 022E USERCOOE: SASHA 

PROCESSOR TIME: 00:00:00.4897 CHARGECODE : 6715. 

l£2n„„ 00:00:01 . 1172 AVERAGE MEMORY USAGE: C00E«731, DATA*2465 

?5 A 929,t I 22 : 22 : 22-A5S9 MEM0RY INTEGRAL: C00E*1.174. dAta*3.961 

ll'ICgiT. TIME: 00:00:00.0874 INITIAL PBITS: 229, OTHER PftlTS: 2. 

OTHERPBIT T ME: 00:00:00.0020 MAXIMUM NUMBER OF ASOS USED: 35 

ELAPSEO TIME: 00:27:39.2064 MAXIMUM SAVE MEMORY USED: 2248. 

{ SA8E )08JECT/TRANSF0RMS ON MCPMAST. 

5IACK,NUM8ERa_039B _ AVERAGE MEMORY USAGE: C0DEO179, 0ATA«131O 



PROCESSOR TIME 



I/O 
REAOYQ 
INITPBIT 
ELAPSEO 



TIME: 
TIME: 
TIME: 
TIME: 



>x5 , AVtK AGt MEMORY USAGE : C0DE=3179, DATA«1. 

22 : 22 : 222255 MEMORY INTEGRAL: CODE»0.282, DATA*0.116 
00:00:00.0501 INITIAL PBITS: 26. 



00:66:65:6376 MAX {MUM NyMBER^qF^ASOS.ySEpi.lS , 
00:05:24:6090 



*i w nnAinun nvnutn %jf r\&u<* ujcu: i: 

133 MAXIMUM SAVE MEMORY USED: 1009. 



*SYSTEM/IGSDASUPPORT. 
STACK NUMBER: 03F0 
PROCESSOR TIME: 00:00:OC 
I/O TIME: 00:00:0( 

8§ A QX9.. TIME: 00:OQ:OC 
INITPBIT TIME 
ELAPSEO TIME 



00:00:OC 



00:00: 



.1213 8s V |^§§E? , P S Sw SECT0RS ' M USE BY PERMANEMT F,LES 
.8821 CHARGECODE: 6685. 

.0330 AVERAGE MEMORY USAGE: CODE*2662. 0ATA«25799 

■M Wfk'nw L i^ mmtMi - »**»■»••»» 

MAXIMUM NUMBER OF ASDS USED: 40. 
MAXIMUM SAVE MEMORY USEO: 31825. 



loganalyzer ver 
mcp *!>ystem/mcp 
analyzeo by ais 



§i2KA,l 9 .-.922:2?. 5 .. SOASUPPORT VERSION: 
7)90236 VERSION: 39.024 (MCP/AS] 
(SYSTEM SERIAL « 8 ON 0" ' 



39.023.375, JOBFORMATTER VERSION: 39.023.328. 



4/03/1990 18:00:55 



REQUEST: PRINTER 1500 TO 1630 EOT USERCOOE 

_J3 #0( 
TITLE 



(UNSORTED BY DEFAULT) 



MM* '00?; ? 1 H 5»CAUO 8Y Jil K <f «T|«„f E«ij5«- oS ,»> « 04/03/1,90 15 :5 3:, 6 



FILE CONTAINS 33333 RECORDS FROM 04/03/1990 15:54:00 TO 04/03/1990 18:02:00 



Tuesday. 
15:53 



HI 



la/ 8 ? 0 



875 



15:53:38 EOT 5879 



15:53:38 



EOJ 5878 



15:53:42 EOT 5873 



15:53:48 



EOT 5864 



"UPOATE FAULTLOG . 
STACK NOMBER : 030B 
PROCESSOR TIME: 00:00:00 
TIME 



I/O 

REAOYQ 
INITPBIT 
ELAPSED 



...... 00:00:00 

TIME: 00:00:00 
TIME: 00:00:00 
TIME: 00:00:00 



*SYSTEM/FAULTLOGGER. 
STACK NUMBER: 03EO 
PROCESSOR TIME: 00:00:00. 
I/O TIME: 
RtAOYQ TIME: 
INITPBIT TIME: 
0THERP8IT TIME: 
ELAPSED TIME: 



00:00:00 
00:00:00 
00:00:00 
00:00:00 
00:00:00 



0211 
0479 
0390 
0035 
1165 



0446 
0858 
0107 
0210 
0047 
6122 



AVERAGE MEMORY USAGE: CODE'O, DATA=740 
MEMORY INTEGRAL: C0DE«0. 000, DATA=0.051 
INITIAL PBITS: 11. 
MAXIMUM NUMBER OF ASDS USED: 5. 
MAXIMUM SAVE MEMORY USED: 696. 



AVERAGE MEMORY USAGE: CODE=3221, DATA*2680 
MEMORY INTEGRAL: C0DE=0.420, DAtA=0.350 
INITIAL PBITS: 34, OTHER PBlTS: 4. 
MAXIMUM NUMBER OF ASDS USED: IS. 
MAXIMUM SAVE MEMORY USED: 3119. 



"BEGIN J0B:RUN SYS" 
STACK NUMBER: 03DE 



PROCESSOR 



1/0 
RtAOYQ 
INITPBIT 



OTHERPBIT 
ELAPSED 



AVERAGE MEMORY USAGE: CODE=77 J DATA»1086 



ME: 00:00:00.0347 MEMORY ~INT EGRAL: 'CODE'OTodT, ' 6ATA«0 

ME: 00:00:00.0865 INITIAL PBITS: 16, OTHER PBTSVl 

ME: 00:00:00.0074 MAXIMUM NUMBER OF ASDS USED: 5. 

ME: 00:00:00.0087 MAXIMUM SAVE MEMORY USED: 2127. 

ME: 00:00:00.0013 

ME: 00:00:00.8176 



*SYSTEM/DCALGOL ON SYS39. 
STACK NUM8ER: 0307 
PROCESSOR TIME: 00:00:06. 
I/O TIME: 00:00:04, 

REAOYQ TIME: 00:00:00. 
INITPBIT TIME: 00:00:00. 
ELAPSEO TIME: 00:00:14. 



♦OBJECT/ED ON MCPMAST. 
STACK NUMBER: 



c,,c fi¥S8£S£.. OI 5K.. SECTORS IN USE BY PERMANENT FILES: 4447 
5326 USERCOOE: POW. 
3206 CHARGECOOE: 6685. 

5065 AVERAGE MEMORY USAGE : C0DE*40198. DATA*47834 

MAXIMUM NUMBER OF ASDS USED: 300. 
MAXIMUM SAVE MEMORY USED: 22557. 



PROCESSOR TIME 
TIME 



03BE 



I/O 

REAOYQ 

INITPBIT TIME 



TIME 



OTHERPBIT TIME 
ELAPSEO TIME 



„„„„ AVERAGE DISK SECTORS IN USE BY PERMANENT FILES 
9052 . USERCOOE.: POW. 



00:00:00 
00:00:03 
00:00:00 

00:00:00. ..«.-.-. .•„..■.««. ■ . . vwi-iv/.j/j, 

00:00:00.0131 INITIAL PBITS: 404, OTHER PBltS: 9. 
00:02:15 " ' ~" 



7871 



>. s , CHARGECODE: 6685. 

3095 AVERAGE MEMORY USAGE: COOE»27023, 0ATA=17107 
1244 MEMORY INTEGRAL: C0DE«107 . 975 A DATA=68.352 



.8809 MAXIMUM NUMBER.OF.AspS.USED: JJ6 . 



MAXIMUM SAVE MEMORY USED: 



^^§v^ig/^g?)§g^3a^^ii83^39^8ts u Ia8g^AH RS,OM: 39 023 - 375 - 

ANALYZEO BY A15 (SYSTEM SERIAL « 8) ON 04/03/1990 18:03:17 
REQUEST: PRINTER 1600 TO 1630 ERRORS USERCOOE . 



JOBFORMATTER VERSION: 39.023.328, 



MM '00 ? ; ?W «Ej>UO .V A15 K ( ? JST^ E »l»L ol)8 ) ON 04/03/39,0 15:53:36 



TITLE 



FILE CONTAINS 33672 RECOROS FROM 04/03/1990 15:54:00 TO 04/03/1990 18:04:00 



Tuesday. 
16:06 



Ml 



3. 1990 
BdT 5941 



16:00:09 



16:00:09 



16:00:15 



OPEN 5941 



OPEN 5941 



OPEN 5941 



16:00:16 CLOSE 5941 



16:00:16 CLOSE 5941 



.0:35 



BY PASCAL 39.15 



*SYSTEM/CC. 
STACK NUMBER: 0481 
CODE COMPILEO: 03/20/1990 07..... 
TASK TYPE: OEPENOENT TASK(PROCESS 
PRIORITY: 50 
COOEFILE: (JASMI TH )CANDE/C0DE6130 ON DISK. 
USERCOOE: JASMITH. 
CHARGECODE: 6671. 
SOURCENAME: TB263/E/1. 
INITIATING MCS: SYSTEM/CANDE . 

INT NAME- {J5§ MITH '' EDIT0R/TEMp / SP,DER / STREMUI -/MACR0S/H. 
FAMILY NAME: FiRE 

FILE ACCESS RULE = OECLARER (ACTOR = DECLARER = STACK 481. 
USE. = CLOSED KINO=PACK F 1LEK 1ND = CCSYMBOL FILE SIZE 15 



OPENTYPE 
EXT NAME 
INT NAME 
FAMILY NAME 
FILE ACCESS 



WAIT, 
(JASMI 
SOURCE 



PO 
I TH 
OURCE. 
FIRE 
RULE 



SITION: 0. MOTION: NONE 
)SP I OER/StREMUL/MACROS/H . 



OECLARER (ACTOR = DECLARER 



y§E.=. CLOSED K I ND=PACK FILEKIND= CCSYMBOL 



OPENTYPE: WAIT, POSITION: 0, MOTION: NONE 
Ul K A !J§ : (JASMITH)ERRORS/S|5lOER/STREMUL/MACROS/H 
INT NAME: ERRORS. 



= STACK 481. 
FILE SIZE 36 



JOB 4404, TASK 5941) 
SEGS. UNIT NUMBER 63 



JOB 4404, TASK 5941} 
SEGS. UNIT NUMBER 63 



FAMILY NAME: FIRE 

FILE ACCESS RULE * DECLARER (ACTOR = DECLARER * STACK 481. JOB 4404. TASK 5941) 
fen^M W^ FRE S.ZE 0 SEOS. U..I HiMU 53 

(jasmi th) errors/si* i der/stremul/macros/h. 
Errors . 

FIRE 

RULE = DECLARER (ACTOR * DECLARER = STACK 481. JOB 4404, TASK 5941) 

I 00 i 00 ; 00 . 3 538 

S2RW L ASSOCIATION: RELEASE DISPOSITION: SAVE 

ALIGNE0180 PHYS,CAL * REA0 COUNT=0, WRITE C0UNT=19) 



EXT NAME 
INT NAME 
FAMILY NAME 
FILE ACCESS 
10 TIME 
CLOSE TYPE: 
TRANSACTION . 
FILE STRUCTURE 



BUFFERSIZE: 14 

» 0/ 80 INTMODE 
FILE SIZE 90 SECTORS 
VERSION 0 SAVEFACTOR 0 



EBCDIC 



BUFFER CATEGORY: BUFFERGOAL NOT APPLICABLE 
BLOCKS I ZE = 80 MI N/MAXRECS I ZE 

PERM SPEEO*00 UPOATED AREASIZE 90 SECTORS 
SERIAL NO 659063 CREATION DATE 90093 CYCLE 
E 2I K A Bf : iJASMITH)SPIDER/STREMUL/MACROS/H 
INT NAME: SOURCE . 
FAMILY NAME: FIRE 

I0 L T1ME CESS RU 0O00-0O L 0773 (ACT ° R = DECLARER * STACK 481 « J0B 4404 . TA $ K 5941) 
?k9SI.J??Si 22 R ,H$ L 'ASSOCIATION: RELEASE DISPOSITION: BLOCKEXIT 

f?e? s S¥S48¥ug?V N lLTGSioi8o PHVSICAL < REA0 C0UNTO ' WR,TE C0UNT * 0) 



LOGANALYZER VERSION: 39.036.059, SOASUPPORT VERSION: 39.036.044, 
MCP *SYSTEM/MCP/39036D VERSION: 39.036 MCP/AS) 
ANALYZEO BY A15 (SYSTEM SERIAL * 503) ON 10/08/1990 13:53:08 

REQUEST: PRINTER 1318 TO 1320 FILE (UNSORTEO BY DEFAULT) 

SUMLOG '90H39 CREATED BY A9 (SYSTEM SERIAL = 3) ON 06/15/1990 13:17:54 
TITLE = (JAHAR)LASTLOG ON PACKA. 

FILE CONTAINS 721 RECORDS FROM 06/15/1990 13:18:00 TO 06/15/1990 13:36:00 



JOBFORMATTER VERSION: 39.036.432. 



Friday. June 
13:18:27 



13:18:28 



15. 1990 
6PEN 6513 



OPEN 6513 



13:18:30 CLOSE 6513 



13:18:30 CLOSE 6513 



13:24:54 



OPEN 6526 



13:25:25 CLOSE 6526 



TASK 6513) 

' SECTORS 



TASK 6513) 
SECTORS 



WRITE C0UNT«3) 
270 



EXT NAME: ( JAHAR )A1 . 
INT NAME: CARD. 

FILE ACCESS RULE * DECLARER (ACTOR = DECLARER » STACK 08E, JOB 6502 A 
FAMILYNAME MCPTESTS, KIND*PACK UNITNO 48. F I LEKI ND-ALGOLSYMBOL Flit SIZE 14 
USE * CLOSED. OPENTYPE : WAIT. POSITION: d, MOTION: NONE 
EXT NAME: ( jAHAR )CANDE/C0DE1830 . 
INT NAME: CODE . 

FILE ACCESS RULE « DECLARER (ACTOR » DECLARER « STACK 08E. JOB 6502, 
FAMILYNAME MCPTESTS, K IND=PACK UNITNO 48. F I LEK I ND=DATA FILE SIZE 6 
USE » CLOSED, OPENTYPE : WAIT. POSITION: 6, MOTION: NONE 
EXT NAME: ( JAhaR)CAN0E/CO0E1830. 
I NT NAME: CODE . 
FAMILY NAME: MCPTESTS 

FILE ACCESS RULE = DECLARER (ACTOR * DECLARER * STACK 08E, JOB 6502, TASK 6513) 
CLOSE TYPE: NORMAL ASSOCIATION: RELEASE DISPOSITION: CRUNCH 
10 TIME: 00:00:00.0723 TRANSACTION COUNT * 17 PHYSICAL (READ COUNTS 
RESTRUCTURE « AL IGNED180 BUFFER SIZE SOURCE = BLOCKS ZE. BUFFERSlJE 
FRAMESIZE =48, MIN/MAXRECSIZE - 0/ 30, BLOCKSIZE = 270 
INTMODE » SINGLE EXTMODE =■ SINGLE 

UPOATEO CRUNCHED AREASIZE 504 SECTORS. FILE SIZE 18 SECTORS 

SERIAL NO 659048. CREATION DATE 90166 CYCLE 1 VERSION 0 SAVEFACTOR 999 

EXT NAME: ( JAHAR }A1. 

INT NAME: CARO. 

FAMILY NAME: MCPTESTS 

FILE ACCESS RULE = OECLARER (ACTOR = DECLARER » STACK 08E, JOB 6502, TASK 6513) 
CLOSE TYPE: NORMAL ASSOCIATION: RELEASE DISPOSITION: BL&CKEXIT 

10 TIME: 00:00:00.0283 TRANSACTION COUNT « 19 PHYSICAL (READ COUNT-l, WRITE COUNT=0) 

FILESTRUCTURE - AL IGNE0180 , BUFFER SIZE SOURCE » BLOCKS ZE, BUFFERSliE « 420 

FRAMESIZE * 48. MIN/MAXREC§I ZE = 0/ 15. BLOCKSIZE * 420 

INTMOOE * EBCOlC EXTMODE = EBCDIC 

PERM SPEEO=00 AREASIZE 504 SECTORS. FILE SIZE 14 SECTORS 

SERIAL NO 659048, CREATION DATE 90151 CYCLE 1 VERSION 0 SAVEFACTOR 30 

EXT NAME : F4 . 

INT NAME: F4 . 

FILE ACCESS RULE * OECLARER (ACTOR * DECLARER » STACK OAA, JOB 6502, TASK 6526) 

KINO'TAPE UNITNO 162. LABELK1nD= B6500 USASI 

USE * CLOSEO, OPENTYPE: WAIT, POSITION: 0, MOTION: NONE 

EXT NAME: F4 . 

INT NAME: F4 . 

UNITN0 C 162 S DENSITY BPI1600 R (ACT ° R " 0ECLARER * STACK 0AA ' J0B 6502 « TASK 6526) 
C k°$ E J YPE ,A S2 R J}fi L -»„i§ S0CIAT,0N: RELEASE DISPOSITION: BLOCKEXIT 

i8ff B^iJ^BoHt^^LJSJKiyfflFRIHIii i !8 YS,CAL C0UNTs0 « WRITE C0UNT=1) 

IBBH'S EB 4 cS| C M,N/MAXRECS, ^t5oS^ l°t.&?P SI " " 10 

SERIAL NO J JAHAR, CREATION DATE 90166 CYCLE 1 VERSION 0 SAVEFACTOR 0 REEL 1 



B^HfIS/!iERJMhi%Sii!J?'39?85i U fKRAS RSIO " : 39 023 - 375 ' ^FORMATTER VERSION: 39.023.328. 
ANALYZED BY A15 (SYSTEM SERIAL * 8) ON 04/03/1990 18:11:01 
REQUEST; PRINTER JOB 6619 USERCOOE . (UNSORTED BY DEFAULT) 

5^? G S '2§?^Eh5§uS[§S §N fAaK ( ^?N? E §iSU) 8) ° N 04/03/1990 15:53:36 

FILE CONTAINS 34705 RECORDS FROM 04/03/1990 15:54:00 TO 04/03/1990 18:12:00 

Tuesday. April 3. 1990 

17:59:13 BOJ 6619 SI/WFLJOB/"900403- 175911" . 

STACK NUMBER: 07F8 

JMENTEREO SYSTEM: 04/03/1990 17:59:13 FROM WFL 39.23 

ORIGINATING LSN: 183 MCS: 1 
PRIORITY: 50 
USERCOOE: ALAJUA. 
CHARGECODE : 6842. 
SOURCENAME: TMPA15C . 
„„„ INITIATING MCS: *SYSTEM/COMS . 
17:59:13 BOT 6620 (ALAJUA)SOOl . 

STACK NUMBER: 07FA 
TASK TYPE: DEPENDENT TASK PROCESS) 
PRIORITY: 50 
USERCOOE: ALAJUA. 
CHARGECOOE : 6842. 
SOURCENAME: TMPA15C. 
INITIATING MCS: *SYSTEM/COMS . 



17:59:13 BOT 6621 (ALAJUA S002 . 

STACK NUMBER: 07FB 

TASK TYPE: DEPENDENT TASK( PROCESS ) 

PRIORITY: 50 

USERCOOE: ALAJUA. 

CHARGECODE: 6842. 

SOURCENAME: TMPA15C. 

INITIATING MCS: *SYSTEM/COMS . 
17:59:14 6620 MSR0ISP3 : OISPLAY:PROTOCOLS (TAPE) -> DISK (PACK. FAMILY INDEXED 

mh\t bot m QRun^iffttiiti?™"" lun] -> Ip,ck1 • 

STACK NUMBER: 07FC 

TASK TYPE: COROUTINE(CALL) 

PRIORITY: 50 

USERCODE: ALAJUA. 

CHARGECODE: 6842. 

SOURCENAME: TMPA15C . 
-„ INITIATING MCS: *SYSTEM/COMS . 

17:59:14 BOT 6623 *L I BRARY /MAINTENANCE. 

STACK NUMBER: 07F0 

TASK TYPE: COROUTINE(CALL) 

PRIORITY: 50 

USERCOOE: ALAJUA. 

CHARGECODE: 6842. 

SOURCENAME: TMPA15C. 

INITIATING MCS: *SYSTEM/COMS . 
17:59:14 6622 MSRF IN9: NO FILE PROTOCOLS/FILEOOO MT [000425] #1 FAMI LYOVNER* . 

tZ :5 »2 : IS f f 23 MSRF N9: NO FILE PROTOCOLS/FILEOOO MT) [0004251 #1 FAMILYQWNER 

18:00:20 6622 MSRF N6: UNMATCHED SERIALNO PROTOCOLS/FILEOOO (MT J [ 

18:00:20 6623 MSRFIN6: UNMATCHED SERIALNO PROTOCOLS/FILEOOO (MT [ 



000425] fl FAMILYOWNER 
000425] #1 FAMILYOWNER 



-^1 

I 

on 
00 



3 



o 
o 
> 

Z 
> 

J& GA *S\ L ?^^ 40.074.012. JOBFORMATTER VERS ION : 40.074.119. ^ 

AMALYZEO BY A15 (SYSTEM SERIAL = 8) ON 12/04/1991 14:41:04 
REQUEST: PRINTER LIB USERCOOE . (UNSORTEO BY DEFAULT) 

SUMLOG #002688 CREATEO BY A15 (SYSTEM SERIAL = 8) ON 12/04/1991 10:42:00 
TITLE = *SYSTEM/SUMLOG ON OlSKB (CURRENT SUMLOG J . 

FILE CONTAINS ;'8039 RECORDS FROM 12/04/1991 10:42:00 TO 12/04/1991 14:42:00 

Wednesday. December 4. 1991 

14:39:33 LIB 6^07 *0BJECT/MAIL ON SYS39. (STACK BE4) 
DELINK FROM LIBRARY. 

ATTRIBUTES: ^{ 8ACCESS = =^BYFONCTlON^^ = * 5YSTEM/MA 1 LSUPPORT/TEST ON PACK . .FUNCTIONNAME = MAILSUPPORT, 
LIBRARIES: 

6803 (JANB ) SYSTEM/MA I L SUPPORT ON PACK. (STACK 179) 
SECURITY CLASS=1 
, . , ,„ ,„ , % , DELINKAGE WAS SUCCESSFUL. 

14:39:35 LIB 6319 *OBJECT/CHECKMAI L ON PACK. (STACK COO) 



<g lTnk w t6'_ library! 



ATTR I BUTES : ^ j TLE^s^^sySTEM/MAI L^UPPORT /TES T^ON B{k? UPP0RT - UBACCESS = 
LIBRARIES: 

f 6803 ( JANB ) SYSTEM/MA 1 LSUPPORT ON PACK. (STACK 179) 

it> SECURITY CLASS=1 

fo LINKAGE WAS SUCCESSFUL (RESULT VALUE 2), 

■ 14:39:35 LIB 6319 *OBJECT/CHECKMAI L ON PACK. STACK COO 

OELINK FROM LIBRARY. 

t ATTRIBUTES : ^ {le^s M *s Y STEM/MA j LiUPPOR^ p HA .CK SUPP ° RT " UBACCESS " 

DO LIBRARIES: 

Q 6803 !^Jjj}^ S J^5 A { LSUPP0RT 0N PACK - ( STACK 179) 

"2- . DELINKAGE WAS SUCCESSFUL , 

S- 14:40:20 LIB 6322 *SYSTEM/ALGOL. (STACK C06) 



DELINK FROM LIBRARY. 

ATTRIBUTES: INTNAME = GENERALSUPPORT , LIBACCESS = BYFUNCT ION 

fj I [ RR AR I e S * 

C 6598 *SYSTEM/GENERALSUPPORT.- (STACK 041) 

_ SECURITY CLASS=3 
G OELINKAGE WAS SUCCESSFUL. 

S- 14:40:43 LIB 6329 (CUVIERJOBJECT/SPOC/LIBRARY ON DISKB. (STACK 3092) 

LIBRARY FROZEN. 

„n e 0 ... . ... flftiyS.i^IiSRS^ARY. ,BYTITLE. SHAREDBYALL, SECURITY CLASS=0. 

14:40:58 LIB 6329 (CyyiER)0BJECT/SP0i/Ll8RARY ON DISKB. (STACK 3092) 

I I DO Afi Y TH AUc n 

,« cn ... Slftiy?. ^HMf,93 A 5h BTTITLE, SHAREDBYALL , SECURITY CLASS=0. 

14:40:59 LIB 6330 JOBF I LE /CONVERTER . (STACK C18) 
DELINK FROM LIBRARY. 

A IIS!§Vn S: INTNAME = MCPSUPPORT, LIBACCESS « BYFUNCT ION 

I ] DO Afl IpS* 

$ 0015 s|juRITY A CL/lsS P l 40074F - <STACK °° 0) 

O OELINKAGE WAS SUCCESSFUL, 

O _14:41:04 LI8 6332 *SYSTEM/ IGSOASUPPORT . (STACK 3098) 

O LIBRARY FROZEN. 

45» STATUS : TEMPORARY, BYFUNCT ION , PRIVATE. SECURITY CLASS=4, TRUSTED. 
00 

I 

I— » 

o 
o 



fe8^ A 52tVJ?IS/^??|§5i e g 9 V?gii8g? 3 9 S 83i U ?S8gjA?5 RS,ONt 39 036 0 "' ^FORMATTER VERS ION : 39.036.432, 
ANALYZED BY A15 (SYSTEM SERIAL « 503) ON 10/08/1990 13:53:08 
REQUEST: P MIX 6513 THRU 6531 (UNSORTEO BY DEFAULT) 

ff?li s . f fS«a)£SltB8 o 8 N $UV sn « SERIAL x 3) 0N ° 6 ' 15 ' 1990 

FILE CONTAINS 721 RECOROS FROM 06/15/1990 13:18:00 TO 06/15/1990 13:36:00 



Friday. J 
13:18: 



une 
26 



15. 1990 
SOT 6513 



13:18:27 



13:18:28 



TMPA9B1/CAN0E/1. 



STACK 08E, JOB 6502 



13:18:30 CLOSE 6513 



♦SYSTEM/ALGOL ON SYSTESTS. 

CODE COMPILED: 05/29/1990 16 :31 : 15 BY ALGOL 39.28 
TASK TYPE: DEPENDENT TASK ( PROCESS; 
SlfipK N !J HBER: °°$ E i PRIORITY: 50. SOURCENAME: 
CODEFILE: ( JAHAR )CAnDE/C0DE183O 6n SYSTESTS. 
USERCODE: JAHAR. 
,r,, INITIATING MCS: SYSTEM/CANOE. 
OPEN 6513 EXT NAME: (JAHAR )A1. 
INT NAME: CARD. 

FILE ACCESS RULE = DECLARER (ACTOR = DECLARER „„, „„„ 

FAM I LYNAME SYSTESTS , K I ND=PACK UNITNO 48. FILEKIND-ALGOLSYMBOL 
nor U cc, - CLOSED. OPENTYPE: WAIT. POSITION: 6, MOTION: NONE 

OPEN 6513 EXT NAME: (JAHAR )CANDE/C0DE1$30 . 
INT NAME : CODE. 

H!if.S C ,SS§ S .8iltl,?. DE £V ARER (ACTOR ■ DECLARER - STACK 08E, JOB 6502, 
fAMILYNAME SYSTESTS KIND=PACK UNITNO 48. F I LEK I ND=DATA FILE SIZE 6 
USE -CLOSED. OPENTYPE: WAIT. POSITION: 0. MOTION: NONE 
EXT NAME: ( JAHAR }CAN0E/C0DE1$30 . 
INT NAME: CODE. 
FAMILY NAME: SYSTESTS 

FILE ACCESS RULE » DECLARER (ACTOR = DECLARER = STACK 08E, JOB 6502, TASK 6513) 
C k°?LJ YP L NORMAL^^ASSOC I AT ION : RELEASE DISPOSITION: CRUNCH 
10 TIME: 00:00:00.0723 TRANSACTION COUNT = 17 PHYSICAL (READ COUNT=0, 

iffiP T !"ii: WWKMHiiH'IW iCBg.It'PiH'"- "" f »" lE 

INTMODE = SINGLE EXTMODE = SINGLE 

y?S A I EO u « C 5yi!£9I 0 AREASIZE 504 SECTORS. FILE SIZE 18 SECTORS 

!S? IA ,ku£° 6 ^92§W CREAT,OM DATE 90166 CYdLE 1 VERSION 0 SAVEFACTOR 999 
EXT NAME: ( JAHAR )A1. 
INT NAME: CARO. 
FAMILY NAME: SYSTESTS 

FILE ACCESS RULE = DECLARER (ACTOR = DECLARER = STACK 08E 4 JOB 6502, TASK 6513) 
9k°§ E uJ YP L NORMAL ASSOC I AT lON : RELEASE DISPOSITION: BLdCKEX IT ' 
I 0 ,, JIME : 00:00 :00.0283 TRANSACTION COUNT = 19 PHYSICAL (READ C0UNT=1, WRITE COUNT=0) 

INTMODE = EBCDIC EXTMODE = E8C0 IC 

?§S M ., §E E §2«99„ AREASIZE 504 SECTORS. FILE SIZE 14 SECTORS 

13:18:30 EOT 6513 4WAk& 6 0 ITh hi® S™ ° ATE 9 ° 151 1 VERS, ° N ° SAVEFACT0R 30 

USERCODE: JAHAR. 

STACK NUMBER: 008E AVERAGE DISK SECTORS IN USE BY PERMANENT FILES- 205 

PROCESSOR TIME: 00:00:01.0895 AVERAGE MEMORY USAGE : CODE =1 3585^ DATA= 142 85 
T ME: 00:00:00.6281 MEMORY INTEGRAL: CODE=23.334, DATA=24 536 
TIME: 00:00:00.1435 INITIAL PBITS: 231. 
TIME: 00:00:00.4682 MAXIMUM NUMBER OF ASDS USED: 124. 
TIME: 00:00:03.8099 MAXIMUM SAVE MEMORY USED: 10014. 



— ... TASK 6513) 
FILE SIZE 14 SECTORS 



TASK 6513) 
SECTORS 



WRITE C0UNT=3) 
270 



13:18:30 CLOSE 6513 



I/O 
READYQ 
INITPBIT 
ELAPSED 



U^UfiH/S>?lUi32 9 «Sii83?'3»?8Si u TE8P7AXl llsl0 " : 39 023 - 375 « ^formatter version: 39.023.32s. 

ANALYZED BY A15 (SYSTEM SERIAL = 8) ON 04/03/1990 18:20:52 
REQUEST: PRINTER SESSION 5971 USERCOOE . (UNSORTED BY DEFAULT) 

FILE CONTAINS 36568 RECORDS FROM 04/03/1990 15:54:00 TO 04/03/1990 18:22:00 



Tuesday. Apri 
16:07:00 



1 3. 1990 
LOGON 5971 



16:07:01 BOT 5972 



16:07:01 



OPEN 5972 



16:07:01 CLOSE 5972 



16:07:01 



EOT 5972 



ORIGINATING LSN: 521 
USERCOOE: WJW. 
USERCODE PRIVILEGE: PU 
MCS: 2 

CHARGE CODE: 6751. 
STATION NAME: TA274/CANDE/1 . 
SIGN ON BY NEW LOG-ON 
*OBJECT/CHECKMAlL ON PACK , 
STACK NUMBER : 0404 

COOE COMPILED: 03/28/1990 21:02:11 BY DCALGOL 38 93 
TASKJYPE ^DEPENDENT TASK(PROCESS) 30 

USERCOOE: WJW. 
CHARGECODE: 6751. 
SOURCENAME: TA274/CANOE/ 1 . 
INITIATING MCS: SYSTEM/CANDE . 
EXT NAME: REMOTE. 
INT NAME: REMOTE . 
FILE ACCESS RULE = DECLARER 
USE = CLOSED K IND = REMOTE 

9SI N IISI : ^iI+r P0SITI0N: °. MOTION: NONE 
EXT NAME: REMOTE. 
INT NAME: REMOTE. 
FILE ACCESS RULE = DECLARER 
10 TIME : 00:00:00.0000 

CLOSE TYPE: NORMAL ASSOCIATION 



(ACTOR = DECLARER = STACK 404, JOB 5971, TASK 5972) 



(ACTOR = DECLARER = STACK 404, JOB 5971, TASK 5972) 



TRANSACTION COUNT = 1 
BUFFER CATEGORY: BUFFERGOAL 
BLOCKS IZE =80 
*OBJECT/CHECKMAlL ON PACK. 
STACK NUMBER: 0404 
PROCESSOR TIME: 
I/O TIME: 
REAOYQ TIME: 
INITPBIT TIME: 
ELAPSED TIME: 



-.RELEASE DISPOSITION: BLOCKEXIT 
»«? H I§IP i ?k.I R ^ AD COUNT=0. WRITE COUNT=0) 
NOT APPLICABLE BUFFER^IZE: 0 

MIN/MAXRECSIZE = 0/ 80 INTMODE = EBCDIC 



xa ,„ „„ USERCODE: WJW. 

00 : 00 : 00 . 1411 CHARGECODE: 6751. 

00:00:00.1392 AVERAGE MEMORY USAGE : CODE=721, 0ATA=2109 
00:00:00.0130 MEMORY INTEGRAL: CODE=0.202, DATA=0.591 
00:00:00.0280 INITIAL PBITS: 91. 
00:00:00.3310 MAXIMUM NUMBER OF ASDS USED: 28. 

MAXIMUM SAVE MEMORY USED: 2183. 



NORMAL TERMINATION FOR LOGANALYZER PROGRAM. 



00 

cn 
o 
o 

o 

f 

I— 1 

o 
o 



-n 
c 

L 



5 

O 

o' 

3 

o 

c 



ANALYZEO BY A15 (SYSTEM SERIAL » 8) ON 04/03/1990 18:28:57 
REQUEST : PRINTER TASK 6697 USERCOOE . (UNSORTED BY OEFAULT) 
SyHL0 G- .0O07. W R»TE g Sg AlS^.ST^E.J.l^S) 0« 04/03/.990 15 :5 3 :36 

FILE CONTAINS 37475 RECOROS FROM 04/03/1990 15:54:00 TO 04/03/1990 18:30:00 



JOBFORMATTER VERSION: 39.023.328. 



Tuesday. AoriJ 3. 1990 
18:16:40 b6t 6697 



18:19:40 OPEN 6697 



18:19:40 OPEN 6697 



18:19:40 DEIMP 6697 



18:19:40 CLOSE 6697 



18:19:40 CLOSE 6697 



18:19:41 EOT 6697 



*SYSTEM/F I LEOATA . 
STACK NUMBER 



0B6C 

CODE COMPILEO: 03/19/1990 22:37:27 
TASK TYPE: .DEPENDENT TASK (PROCESS) 



22:37:27 BY DCALGOL 39.23 



(ACTOR * DECLARER » STACK B6C, JOB 6692, TASK 6697) 



PRIORITY: 5 
USERCOOE: SLAOO. 
CHARGECODE: 6251. 
SOURCENAME: TB235/CANOE/2 . 
INITIATING MCS: SYSTEM/CANDE . 
EXT NAME : LINE. 
INT NAME: LINE. 
FILE ACCESS RULE « DECLARER 
USE - CLOSEO KINOcREMOTE 

25f N JIE§ : y^lAn^illSS 1 AT FR0NT - MOTION: NONE 
EXT NAME: (SLAOO) JOB6697 . 
INT NAME: DATABASE. 
FAMILY NAME: DCCP 

FILE ACCESS RULE = DECLARER (ACTOR « OECLARER » STACK B6C, JOB 6692, TASK 6697) 

«oSl LE s '" 0 SEGS u "' t *•» « 

COMPILER: DCALGOL 39.23 
ORIGINATING LSN: 500 MCS: 2 
USERCODE: SLADO. 

SETSTATUS 7 MANUAL TATUS DIRECT0RY RE Q U " T MASK BIT 14 WILL BE OEIMPLEMENTED ON MARK 4.0. SEE THE GETSTATUS/ 
EXT NAME: ( SLA00}jOB6697 . 
INT NAME: OATABASE. 
FAMILY NAME: DCCP 
FILE ACCESS RULE « OECLARER 
10 TIME : 00:00:00.0189 
CLOSE TYPE: NORMAL ASSOCIATION: 
TRANSACTION COUNT * 31 PHYSICAL 
FILE STRUCTURE: ALIGNE0180 

EXT NAME: LINE, 
INT NAME: LINE. 

IO L TIME CESS RU 00-00-00 L 0000 (ACT ° R * DECLARER s STACIC B6C « J0B 6692 « TASK 6697 > 
CLOSE TYPE: NORMAL ' ASSOCIATION: RELEASE DISPOSITION: BLOCKEXIT 

b^atirU jrmm* h- mum 

8k?fl1i l>L E 0»l«! 8 " HIN/MAJWECSIZE . 0/ U6 5 

STACK NUMBER: 0B6C AVERAGE DISK SECTORS IN USE BY TEMPORARY FILES: 148. 



(ACTOR * DECLARER * STACK B6C, JOB 6692, TASK 6697) 



RELEASE 

(READ COUNT 



DISPOSITION: REWIND 

" 1. WRITE COUNT 1 



1) 



BUFFERS I ZE : 900 
tZE « 0/ 30 
600 SECTORS 



INTMOOE > SINGLE 



CREATION OATE 90093 CYCLE 1 VERSION 0 SAVEFACTOR 0 



INTMOOE * EBCDIC 



o 
o 
> 
z 
> 

m 

30 



LOGANALYZER VERSION: 39.023.045, SOASUPPORT VERSION : 39.023.375, OOBFORMATTER VERSION: 39.023.328. 

MCP *SYSTEM/MCP/39023G VERSION: 39,024 (HCP/AS) 

ANALYZED BY A15 (SYSTEM SERIAL » 8) ON 04/04/1*90 10:18:31 

REQUEST: PRINTER COMMENT USERCOOE . (UN SORTED BY DEFAULT) 

SUMLOCi #000785 CREATED BY A15 (SYSTEM SERIAL * 8) ON 04/04/1990 06:01:43 
TITLE = *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 72061 RECOROS FROM 04/04/1990 06:02:00 TO 04/04/1990 10:20:00 
Uprfnp'Hav Aor \ 1 4 1990 



NORMAL TERMINATION FOR LOGANALYZER PROGRAM. 



fc8g A ^%r5fllS/J!i?5|8g^2a 9 V?lii8S?-39t8§i U ?58^jAn RSION: 39 020 035 . ^FORMATTER VERSION: 39.022.324. 
ANALYZED BY A1S (SYSTEM SERIAL - 8) ON 03/14/1990 14:15:57 

REQUEST: P /000705 1000 TO 1005 OE IMPLEMENTATION USERCODE. (UNSORTEO BY DEFAULT) 

?¥¥t? 6 - # 2i8S?g G ?g58I fSsSJoSiloi s Sg T Kc^ ER 1 AL " a) 0N 03/14/1990 09:33:46 

FILE CONTAINS 88014 RECOROS FROM 03/14/1990 09:34:00 TO 03/14/1990 13:47:00 

Wednesday. March 14, 1990 

10:00:02 0E1MP 3580 *FILERECOVERY ON PACK . 

COMPILER: ALGOL 36.191 
ORIGINATING UNIT: 51 

SSKEUi! yA&°"™ 0N PACK - 

10:00:03 0E1MP 3582 HMBf A joIS^XUitf iSiKWB. 0 " ™ E «" 

USERCODE: JJBACKUP. 

10:00:0« OE.HP 1578 ffflUMUtfiilfW " °" THE " E " 

COMPILER: DCALGOL 38.83 
ORIGINATING LSN: 634 MCS: 2 
USERCODE: ORV. 

10:00:06 OEIMP 3586 H3II!8uf?ijSII8i»5? RCHER """" K U5E ° F ° R A ' TRIBUTES AD0ED AF ™ MARK 3. 
COMPILER: DCALGOL 39.22 
ORIGINATING UNIT: 0 
USERCODE: JJBACKUP. 

10:00:09 OCIHP }S80 WtlS!MYi3%<8®U'-*- ™ E ,A " UIU " """'"HMTEO 

tei^i^oiK?? 1 »»•« 

USERCODE: JJBACKUP. 

10:00.22 OEIMP 3594 ^LIrIcSvER? Wa^.*' ™ E SUBSYSTEM ATTRIBUTE W ' LL « « '"CEMENTED 

COMPILER: ALGOL 36.191 
ORIGINATING UNIT: 51 
COOEFILE: *FILERECOVERY ON PACK. 
USERCODE: JJBACKUP. 

10:00:22 DE IMP 3595 »3K!M ioI3£ET988SiiS£t f sSftB^^B^SK . ° M ™ E B " T ,ELEA$E 
COMPILER: DCALGOL 36.191 
ORIGINATING UNIT: 51 
USERCOOE: JJBACKUP. 

10:00:25 OE.MP 3597 ¥3$BACKUP jjJBACKUPDB . E ' EE ""' T " " UB °» ™ E " E " ,ELEME 
USERCODE: JJBACKUP. 
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faS^SfrJfiB/iSEP^ISfliai^vESiiSat-aS^BSt^ESP;*^; 11510115 39 023 375 - JOBF0RMATT « VER SI 0N: 39.023.328. 
ANALYZED BY A15 (SYSTEM SERIAL * 8) ON 04/04/1990 10:38:22 

REQUEST: PRINTER MSG USERC0DE . (UNS0RTED BY DEFAULT) 

SUML0G 1000785 CREATED BY A15 (SYSTEM SERIAL - 8) ON 04/04/1990 06:01:43 
TITLE = *SYSTEM/SUULOG ON PACK (CURRENT SUMLOG). uo.mi.hj 

FILE CONTAINS 79304 RECORDS FROM 04/04/1990 06:02:00 TO 04/04/1990 10:39:00 

Wednes 
06: 
06 



06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 

Hi 

06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 
06: 



day, April 4, 
01:46 
01:57 
01:57 
02:01 
02:33 
02:55 
02:55 
03:19 
03:32 
03:59 
03:59 
04:40 
04:40 
04:58 
05:19 
05:19 
05:42 
05:42 
06:59 
06:59 
07:25 
07:25 
08:43 
08:43 
09:05 
09:05 
09:18 
09:37 
10:48 
10:48 
11:04 
12:48 
12:48 
14:19 
14:19 
14:32 
14:32 
14:40 
16:17 
16:17 
18:01 
18:01 
19:21 
21:36 



06:21:40 
06:21:44 



1990 
7297 
2562 
2562 
2543 
2543 
2562 
2562 
2537 
2543 
2537 
2562 
2562 
2562 
2537 
2537 
2562 
2562 
2562 
2562 
2562 
2562 
2562 
2562 
2562 
2562 
2562 
2537 
2543 
2562 
2562 
2537 
2537 
2543 
2562 
2543 
2562 
2562 
2537 
2562 
2562 
2562 
2562 
2537 
2557 

2557 

2557 



1LE BLOCKSIZE 9 (63836500] 
LE BLOCKSIZE I (63836500] 



MSRDISP3 : DISPLAY: FLOG file not found: *SYSTEM/FL0G. . 
MSRPREFMT34: WARNING:H0ST IRV # 325 MAY HAVE STATE MISMATCH. 
MSRPREFMT34: HOST IRV I 325 IS STILL ESTABLISHING 

fi§5XftSB£3§ : w . A S N iHS !§ : logical file blocksize inconsistent with physical f 

Bi^8??S?!4: w a§gi N gA58 5 5b§ G i c tfe 2 F lk E N§b 0 §gfH E INC0NS1STEMT WI ™ physical f 

mnrnm host wmw ii e w s i mJkim ,SH,NG 

MSRPREFMT3^ W H0ST N 325 1 IS L NOW L QUIET CKS1ZE INC0NSISTENT WITH PHYSICAL FILE BLOCKSIZE 9 (63836500) 

MSRPREFMT34: HOST IRV f 325 IS NOW ESTABLISHING 

WARNING:H0ST CAN0553B # 162 MAY HAVE STATE MISMATCH, 
f 162 IS STILL ESTABLISHING 
IS NOW INTERRUPTED 
IS NOW QUIET 
IS NOW ESTABLISHING 
325 MAY HAVE STATE MISMATCH. 



MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34 : 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34 
MSRPREFMT34 



f 162 
f 162 
« 162 
IRV t 



HOST CAN0553B 
HOST CAN0553B 
HOST CAN0S53B 
HOST CAND553B 

WARNING: HOST . 
HOST IRV f 325 IS STILL ESTABLISHING 

WARNING: HOST CAND553B # 162 MAY HAVE STATE MISMATCH. 
HOST CAND5538 # 162 IS STILL ESTABLISHING 

WARN 1NG: HOST IRV # 325 MAY HAVE STATE MISMATCH. 
HOST IRV # 325 IS STILL ESTABLISHING 

WARNING:HOST CANDS538 f 162 MAY HAVE STATE MISMATCH. 
HOST CAND553B # 162 IS STILL ESTABLISHING 
HOST IRV # 325 IS NOW OUIET 
HOST IRV # 325 IS NOW ESTABLISHING 
HOST CAND553B # 162 IS NOW ACTIVE 

S«?S?!4: WA w!J«fN 8?Aok? G !SC L # F JH Sk? c S«Ps}Sf? N 5iaSfjH WITH PHYSICAL FILE BL0CKSIZE 9 {63836500) 

MSRPREFMT34: HOST IRV # 325 IS STILL ESTABLISHING 
HOST IRV # 325 IS NOW ACTIVE 
HOST IRV # 325 IS NOW QUIET 
HOST IRV #325 IS NOW ESTABLISHING 
HOST CAND553B # 162 IS NOW QUIET 
HOST CAND5538 I 162 IS NOW ESTABLISHING 

WARNING: HOST IRV # 325 MAY HAVE STATE MISMATCH. 
HOST IRV # 325 IS STILL ESTABLISHING 
HOST CAND553B f 162 IS NOW ACTIVE 
WARNING:HOST_IRV f 325 MAY HAVE STATE MISMATCH. 



MSRPREFMT34 
MSRPREFMT34 . 
MSRPREFMT34 : 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34 : 
MSRPREFMT34 : 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34 : 
MSRPREFMT34: 
MSRPREFMT34: 
MSRPREFMT34 : 



HOST IRV f 325 IS STILL ESTABLISHING 
HOST IRV # 325 IS NOW OUIET 
HOST IRV I 325 IS NOW ESTABLISHING 
HOST IRV f 325 IS NOW ACTIVE 
COMS: 06:21 MONITOR >>> DCERROR 



TY(CHAR).FLAGS«STATION/LINE NOT ROY, 
MSRPREFMT34 : COMS: 06:21 MONITOR >>* DCERROR: 
TY(CHARl ,FLAGS=STATION/L INE NOT ROY; 
MSRPREFMT34: COMS: 06:21 MONITOR >>$ DCERROR: 



06:21:35 TA270(333) TERMINATE ERROR: LASTFLAG-VERTICAL PARI 
06:21:39 TA242(327) TERMINATE ERROR: LASTFLAG" VERTICAL PARI 
06:21:43 TA242(327) TERMINATE ERROR: LASTFLAG-VERTICAL PARI 
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LOGANALYZER VERSION: 39.023.045, SOASUPPORT VERSION: 39.023.375 JOBFO 
MCP *SYSTEM/MCP/39023G VERSION: 39,024 (MCP/AS) =>. 
ANALYZED BY A15 (SYSTEM SERIAL = 8) ON 04/04/1990 10:35:58 

REQUEST : PRINTER OPERATOR USERCOOE . (UNSORTEO BY DEFAULT) 

SUMLOG #000785 CREATEO BY A15 (SYSTEM SERIAL = 8) ON 04/04/1990 06:01:43 
TITLE = *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 78606 RECORDS FROM 04/04/1990 06:02:00 TO 04/04/1990 10:37 



nesday. April 


4 , 


1990 
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► 2529 


OPERATOR 


07 


04 


03 




► 2529 


OPERATOR 


07 


04 


03 
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07 


04 


34 




► 2523 


OPERATOR 


07 


04 


37 




>7379 


OPERATOR 


07 


04 


37 




>7380 


OPERATOR 


07 


04 


38 




► 7382 


OPERATOR 


07 


04 


42 




► 7385 


OPERATOR 


07 


04 


42 




► 7378 


OPERATOR 


07 


04 


47 




► 7388 


OPERATOR 


07 


04 


47 




► 7374 


OPERATOR 


07:04 


47 




>7378 


OPERATOR 


08 


30 


24 




>7502 


OPERATOR 


08 


31 


48 




>7508 


OPERATOR 


08 


32 


21 




► 7508 


OPERATOR 


08 


32 


26 




► 7508 


OPERATOR 


08 


38 


53 




>7530 


OPERATOR 



ENTERED: 
ENTERED : 
ENTEREO: 
ENTEREO: 
ENTEREO: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTEREO: 
ENTERED: 
ENTERED: 
ENTERED: 
ENTEREO: 
ENTERED : 
ENTEREO: 
ENTEREO; 
ENTERED: 
ENTEREO: 
ENTEREO: 
ENTEREO: 
ENTERED: 
ENTERED; 
ENTERED: 
ENTEREO: 
ENTEREO: 
ENTEREO: 
ENTERED: 
ENTEREO: 
ENTERED: 
ENTEREO 
ENTEREO 
ENTEREO; 
ENTERED : 
ENTERED: 
ENTERED 



2538 i SM: TO ELISE REMINDER: YOU HAVE 2 NEW MAIL MESSAGES. 

10 111" : Q QU!T 

ID 111 : CLEAR 
2554 SM:STATUS 328-339. 
2557 SM :READY 328-339. 
7304LP 
2577LP 
2554LP 

7304, 2577, 2554. 2538. 2529, 2526, 2525, 2517LP 
2529 SM: MAXTASKS =150. 
2529 SM: MAXSTAT I ONS = 250. 



SM: 
SM: 



2529 
2529 
2529 SM: 
2529 SM: 
2529 SM: 
2529 SM: 
2529 SM: 
2529 SM: 
2529 SM: 
2529 SM: 
2529 SM 



13. 
5. 



19. 



MAXGRINOS = 
GRINOLIMIT 

FACTOR WORK = 80 QUIT 
DEPTH = 10. 
NEWS. 

SCHEDULE USERL IMIT 2. 
SCHEDULE 5. 
LAISSEZF ILE = 4. 
LGSTA M333. 

LGOP ♦ M333: LGOFF. LGERR, AUTOINFO. 
OP ♦ ALLMSG. SWAPALL, DIALLOGIN. SCATTER. 

STARTTIME = 15:30; QUEUE = 5; RUN *SUPPRESS/MI X/NOS ON PACK 

8 

MC 
MC 
MC 
Pi 
000 

PS DEVICES+LP4 
SB PACK =OLBACKUP TAPE7 
HU SITE. 

COMP I LERTARGET = LEVELO 
10 108 : OPTION = NONE 

OP- 0 (ERROR: VALUEO .1 ,3.6 ,7 ,9 . 10, 11 . 13, 15.17, 18 ,22.29 ,47 
10 109 : OPTION = NONE 



BEGIN JOB NEWS; 
Mg 0 MIXLIMIT* 
4 MIXLIMIT= , 
0 DEF(PRI=50 
30 MIXLIMIT= 2 
DEV+ LPS 



LIM, 
DEF ( 



(PRI=99 
PRI=40) 



=TAPE7 TAPE9 =TAPE9 PETAPE S PETAPE TAPE =TAPE DISK =DLBACKUP 



§9..!*i?tI¥!lT = _ 0 A _D£F(PRI=50) 



*SUPPRESS/MIX/NOS. 
7502LP- 
7508 IL MT 28 

7508 FA : T ITLE S MB/SY STEM/GAMMA/STANDALONE ON ASD. 

7508 AX:OK. 

7530LP- 



o 

> 



en 



m 



fag^ A S!S^£fiB/8Ee?18Si22*vE8ii83?-39 s 8Sf u f&8P7^f RSZOMs 39 - 020 035 - ^formatter version 

ANALYZED BY A15 (SYSTEM SERIAL = 8) ON 03/14/1990 14:18:05 

REQUEST: P /000705 1330 TO 1400 SECURITY USERCOOE. (UNSORTEO BY DEFAULT) 

?y?l:? G = # 2i85EaG5§^8I!?9§}o^Po4 s ^ T Kc^ ER1AL = 8) 0N "^/u/iqw 09:33=45 

FILE CONTAINS 88014 RECORDS FROM 03/14/1990 09:34:00 TO 03/14/1990 13:47:00 
Wednesday. March 14, 1990 

13:30:24 8289 §fg^}{J N V c §^TI0N - INCORRECT PASSWORD 

ERROR ITEM: KAY. 
ORIGINATING UNIT NUMBER: 0 

13:30:24 8289 MCS SECURITY VIOLATION: 

INy*LIO USERCODE/PASSWORO AT LOG ON 
ORIGINATING LSN: 688 ORIGINATING MCS : 2 
■ S ,J A n2Hr NAME: TC103/CANDE/7 
USERCODE: KAY 
ERROR ITEM: KAY 

13:41:16 8289 §f JJ^V JgL AT I OM - INCORRECT USERCODE 

ERROR ITEM: SABE. 
ORIGINATING UNIT NUMBER : 0 

13:41:16 8289 MCS SECURITY VIOLATION: 

lNYfiU? T USERC00E/PASSVORD AT LOG ON 
ORIGINATING LSN: 671 ORIGINATING MCS: 2 

^r T co°Se^^e T8125/cande/3 
error item: sabe 

13:41:23 8289 §ECUR I TY^VIOLATION - INCORRECT PASSWORD 

ERROR^ITEM: KEIFFER. 
ORIGINATING UNIT NUMBER: 0 

13:41:24 8289 MCS SECURITY VIOLATION: 

INVALID USERCOOE/PASSWORD AT LOG ON 

HflfflBfci3||B>«-W!'-«-"-« 

ERROR ITEM: KEIFFER 



NORMAL TERMINATION FOR LOGANALYZER PROGRAM. 



fc^ A ^^fIS/^^5i^3^ 9 V?IIi^?'39t85i U ?^jA^ RSIOM: 39 " 023 - 375 . JOBFORMATTER VERSION: 39.023.328. 
ANALY2E0 BY A15 (SYSTEM SERIAL « 8) ON 04/04/1990 11:20:57 



REQUEST: PRINTER EOT OUMP USERCOOE. 



(UNSORTED BY DEFAULT) 

8) ON 04/04/1990 10:55:49 



SUMLOG #000786 CREATED BY A15 (SYSTEM SERIAL 
TITLE = *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG) 

FILE CONTAINS 11015 RECOROS FROM 04/04/1990 10:56:00 TO 04/04/1990 11:22:00 



04/04/1990 10:55:49, 
010220FA20FA 
000000000000 
000000000000 
000000000000 
000000000000 
AA4008270017 
000000005A2F 
000000000000 
000000000023 
000OOO0O0EA9 
C6C1F1F5C3C4 

Wednesday. April 4, 
10:55149 EOJ 



9252 8442/84 
000000015FEE 
OOO0OO40OO2F 
00000001A31E 
20B8992B1F45 
23AE7795E721 
000000000000 
00000000009A 
000000000000 

oooooooooooo 

0O00O000024F 
08010104E2D7 



42 TYPE: 1.2 
000301441654 
000000200033 
O0OO0OO33C25 
00004602541F 
24F2F468E7AF 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
18010304C6C9 
C1E900000000 



LENGTH: 53 (4 

BC35O001O0O2 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

000000000005 

000000275569 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

2515461187E8 

D3C507C8C1D5 



7 FIXED) 
00000000004B 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
0OOO0OO19D2O 
4E7E3011CC06 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
C4D3C5D907D3 



1990 
8442 



24 



Fl LI 



FILE/HANDLER/SFA12AB. 

STACK NUMBER: 024F AVERAGE DISK SEC 

PROCESSOR TIME: 00:00:00.2575 USERCODE: SASHA. 

I/O TIME: 00:00:00.5088 AVERAGE MEMORY USAGE: C0DE=95165, DATA=3679 

? E . A 2X9., 00 : 00 :00 -2538 MEMORY INTEGRAL: C00E = 72.926, 0ATA=2.819 

INITPBIT TIME: 00:00:00.0554 INITIAL PBITS: 154. 
ELAPSED TIME: 00:00:06.1866 MAXIMUM NUMBER OF ASDS USED: 35. 

MAXIMUM SAVE MEMORY USED: 3753. 



04/04/1990 10:55:52. 
O1022OFE2OFE 
000000000002 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
0OOOOO0O057B 
■ OOOOOOOOOOOO 
000000000005 
000000000288 
C70000000000 



2672 8446/844 
000000015FEE 
O000O040O02F 
0O0OOO00230B 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOB 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
000000000255 



6 TYPE: 1.2 
00030152FA24 
OOOOOOOOOOOO 
0OOOO0O0B0A6 
000002469EB7 
2495EEFB8659 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
1301010FE407 



LENGTH: 51 (4 

BC330001O0O2 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

000000000005 

OOOO0OO22D21 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

OOOOOOOOOOOO 

C4C1E3C56DC6 



7 FIXED) 
000000000050 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
0000000136E8 
4E7E3D150CC7 
OOOOOOOOOOOO 
OOOOOOOOOOOO 
C1E403E3D3D6 



UP 



10:55:52 EOJ 8446 "UPDATE FAULTLOG". 

STACK NUMBER: 0255 AVERAGE MEMORY USAGE: CO0E=O, DATA=702 

PROCESSOR TIME: 00:00:00.0220 MEMORY INTEGRAL: CODE=0.000, DATA=0.092 
1/0 TIME: 00:00:00.1085 INITIAL PBITS: 11. 

REAOYO TIME : 00:00:00.1910 MAXIMUM NUMBER OF ASDS USED: 5. 
ifllElU Il M i : 00:00:00.0033 MAXIMUM SAVE MEMORY USED : 696. 
ELAPSEO TIME: 00:00:00.3423 



04/04/1990 10:55:54.9856 8450/8450 TYPE: 1,2 
010221022102 000000015FEE 0003016442^4 



LENGTH: 53 (47 FIXED) 
BC3500010002 00000000004B 



h8» A SSVSfi&/8EP?}S8232 9 vK3i8Sf-39?8S3 u ¥iS8S; A SS fcsIoai: 39 023 - 375 - J ° BF0 " HA ^ R version: 39.023.32a. 

ANALYZED BY A15 (SYSTEM SERIAL = 8) ON 04/O4/199O 11:24:04 

REQUEST: PRINTER 1100 TO 1110 80T EOT UNSORTEO USERCOOE. (UNSORTEO IS NOW DEFAULT) . 

SUMLOG #000786 CREATED BY A15 (SYSTEM SERIAL =8) ON 04/04/1990 10:55:49 
TITLE = *SYSTEM/SUMLOG ON PACK (CURRENT SUMLOG). 

FILE CONTAINS 12210 RECORDS FROM 04/04/1990 10:56:00 TO 04/04/1990 11:25:00 

Wednesday. April 4, 1990 

11:00:05 EOT 8481 MAIL/REMINDER. 

STACK NUMBER: 0293 AVERAGE MEMORY USAGE: C0DE=103172, 0ATA=3760 

PROCESSOR TIME: 00:00:10.3289 MEMORY INTEGRAL: C0DE=1100 . 138 A DATA=40.092 

I/O TIME: 00:00:00.3341 INITIAL PB1TS: 6651, OTHER PBltS: 62. 

READYO TIME: 00:00:02.4548 MAXIMUM NUMBER OF ASDS USED: 24 

INITPBIT TIME: 00:00:01.8576 MAXIMUM SAVE MEMORY USED : 2569. 

OTHERPBIT TIME: 00:00:00.1137 

ELAPSED TIME: 00:00:56.3818 

11:00:17 BOJ 8483 (RASHID)OBJECT/PATCH/NED ON FIRE. 

STACK NUMBER: 029A 

COOE COMPILED: 10/19/1989 14:21:20 BY DCALGOL 37.303 

8UEUE: 0 
RIGINATING LSN: 464 MCS: 1 
PRIORITY: 80 
USERCODE: CHANDU . 
CHARGECOOE: 6731. 
SOURCENAME: TB243. 
„ „ INITIATING MCS: *S YSTEM/COMS . 

11:00:20 BOT 8484 *08JECT/ED ON MCPMAST. 

STACK NUMBER* 029C 

COOE COMPILED: 03/19/1990 23:08:01 BY DCALGOL 39.23 
TASK TYPE: DEPENDENT TASK( PROCESS ) 
PRIORITY: 50 
USERCOOE: LOCARNA. 
CHARGECOOE: 6685. 
SOURCENAME: TB109/CAN0E/3 . 
INITIATING MCS: SYSTEM/CANDE . 
11:00:25 BOJ 8485 (R AS HIOJOBJECT/PATCH /NED/PARSER ON FIRE. 
STACK NUMBER: 0290 

COOE COMPILEO: 10/05/1989 13:51:31 BY DCALGOL 37.303 
QUEUE: 0 

ORIGINATING LSN: 464 MCS : 1 
PRIORITY: 50 
USERCODE: CHANDU. 
CHARGECOOE: 6731. 
SOURCENAME: TB243. 
INITIATING MCS: *SYSTEM/COMS . 
11:00:37 SNTX 8327 *SYSTEM/NEWP ON SYS39. 

STACK NUMBER: 019C AVERAGE DISK SECTORS IN USE BY TEMPORARY FILES: 184940 

PROCESSOR TIME: 00:03:36.0610 AVERAGE DISK SECTORS IN USE BY PERMANENT FILE$; 569455 

READYO TIME: 00 :01 : 27 '. 1873 CHARGECOOE : 6685 . 
INITPBIT TIME: 00:00:01.8125 LINES PRINTED: 122. 

2 TH J5EB IT 00 : 00 : 00 . 9429 AVERAGE MEMORY USAGE: C0DE=63864, DATA=672092 

ELAPSED TIME: 00:13:19.0179 MEMORY INTEGRAL: C00E=33644 .095, DATA=354064 . 143 

INITIAL PBITS: 3611. OTHER PBITi: 377. 

MAXIMUM NUMBER OF A$DS USED: 3279. 



feg^SVSflS/JSHSJiSgiig^vgSIiSSf '3 9 f8§i U ?Sg?jA¥I RSIONl 39 030 042 . ^FORMATTER VERSION: 39.031.392. 
ANALYZED BY A15 (SYSTEM SERIAL » 8) ON 07/24/1990 18:39:06 
REQUEST: PRINTER 1800 TO 1810 BOT FILE USERCOOE . SORTED 

?V¥t? G - # 2§U?iM5§5ISfg8 II StiK { ?S?N? ER suaU) 8) 0N 07/2 " /I99 ° 15:17:29 

FILE CONTAINS 83929 RECORDS FROM 07/24/1990 15:17:00 TO 07/24/1990 18:40:00 



Tuesda 



sdav. July 24. 1990 
18:01:07 * Bdj 0111 MCP/HOST. 



JOB ENTERED SYSTEM: 07/24/1990 18:01:07 FROM WFL 39.31 
QUEUE: 30. ORIGINATING LSN: 589 MCS: 2 
?,I A £LKy M fe.,. 07C0 « PRIORITY: 40. SOURCENAME: TB131/CAN0E/1 . 
UScnCUUb: WONG. 
CHARGECODE: 1835. 

,o «, «, „« T IN I T I AT I NG MCS: SYSTEM/CANDE . 

18:01:07 BOT 0112 *SYSTEM/PATCH ON SYSPK. 

COOE COMPILED: 06/27/1990,11:59:46 BY ALGOL 39.30 
TASK TYPE: DEPENDENT TASK(PROCESS ) 

STACK NUMBER: 07C3, PRIORITY: 40, SOURCENAME: TB131/CAN0E/1 . 
UotRCOUE: WONG. 
CHARGECODE: 1835. 

18:01:07 OPEN 0112 EXT T NAME? G CARO ! SYSTEM ' C * NDE ' 
INT NAME: CARO. 

i F .^ E , A ?£ E lf u Sykl»ncR E 9k^F,R« oc ift9I9 R ' declarer » stack 7C3. job 0111. task 0112) 



y§§..:..iS ^INQ«READER T jPSEUDOREADER) 
_PK. 

COOE COMPILED: 06/27/1990 12:31:47 BY NEWP 39.30 



18:01:09 BOT 0113 8SHHIS«E» 'J* ??§p! l0M: °« M0TI0 * : N0NE 
.... -^pj- - 



TASK TYPE: COROUTINE(CALL) 
^S^ll!rMSp/2^{i/U R oS R iJ?f. 40 - SOURCENAME : TB131/CANDE/1 
USERCOOE: WONG. 
CHARGECODE: 1835. 



INT NAME: CARD. 
FAMILY NAME: MCPMAST 



FILE ACCESS RULE » DECLARER (ACTOR » DECLARER » STACK 7C7. JOB 0111 TASK 0113) 

u,e= 5 3 60J o„s g W^W-' 1 "^^ F,lE " SE ' S - ta,E " W 

QUEUE: 0. ORIGINATING UNIT: 0 
.6:03:26 BOO 0.17 feo*" 1 ^ 80 

S8| u |? T !l"oiTSISSti82 / ESiii 9 l? 5 1 8d§? : l 5 wfL 

STACK NUMBER: 084F, PRIORITY: 45, SOURCENAME: TB154/CANDE/4 . 



8600 0478-100 



Section 8 
LOGGER 



This section describes the LOGGER utility program, which enables a user to obtain 
reports that aid in the analysis of system performance and utilization. LOGGER also 
serves as a basis for the installation's billing system. The following are two important 
features of this log analysis program: 

• LOGGER generates a wide variety of reports, depending on individual installation 
requirements. 

• LOGGER combines data over various time intervals in order to generate long-term 
reports. 

LOGGER accepts a set of report-specification commands from the user and interprets 
these specifications. These commands can specify information such as which data from 
each log file is to be included in the report, sorting by a particular data item, and data 
items to be used as control breaks. Usually, a set of report specifications consists of 
only six or seven commands. Therefore, the setup time involved in running LOGGER 
is minimal. If an installation has several different reports that it periodically wishes 
to obtain, the reports can be kept in one disk file. At run time, LOGGER reads the 
appropriate report specifications from this file. 

Original data for LOGGER is stored in either the current log file (SYSTEM/SUMLOG) 
or in one or more of the SUMLOGS created with the TL (Transfer Log) system 
command. LOGGER can also generate reports from files that it saves each time it is 
run, thereby avoiding the need to load large numbers of SUMLOG files in order to 
generate weekly or monthly reports. 

When run, LOGGER can be instructed to obtain the data necessary for a specified 
report from one of four sources: 

• SYSTEM/SUMLOG. Refer to Section 12, "SUMLOG," for information about this 
file. 

• SUMLOG files for either one date or a range of dates. 

• Files generated and saved from a previous run of LOGGER. 

• The disk resource control (DRC) system resource usage contained in the 
USERD ATAFILE . 

Each time LOGGER is run using SUMLOG files as the source, it creates files titled 
JOBSUMMARY/<mmddyy> and STATISTICS/<mmddyy> and, optionally, a file titled 
FILEIODATA/<mmddyy>. These files contain the saved data referred to previously 
along with the information needed to generate additional reports. Subsequently, 
LOGGER can be run with specifications to generate a report from one of these files or 
from files covering a range of dates. 
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LOGGER 



Thus, long-term reports can be generated without having all of the original log files 
present. The saved files are much smaller than the original log files. For example, 
LOGGER could be run each day of the week and the log files removed. At the end of 
the week, LOGGER could also be used to generate a weekly report using the files that 
it created daily. 

LOGGER can generate detailed and summary reports. A detailed report consists of one 
line for each record in the file; a summary report consists of one line for a particular 
group of records. 

LOGGER Operation 

LOGGER operates in two main phases. During the first phase, LOGGER creates data 
files containing the information necessary to generate a report. During the second 
phase, LOGGER reads the files and generates a report. The first phase is bypassed if 
LOGGER is instructed to use existing data files to generate a report. 

LOGGER creates the files JOBSUMMARY, STATISTICS, DRCDATA, and 
FILEIODATA during the first phase of operation. These files contain the data 
necessary to generate reports. The JOBSUMMARY file contains data on each job, task, 
and message control system (MCS) session. The STATISTICS file contains overall 
system statistics such as number of jobs run and number of halt/loads. This data is 
grouped by 15-minute intervals. The FILEIODATA file contains data on file usage 
obtained from file open and close log entries. The JOBSUMMARY and STATISTICS 
files are always created; however, the DRCDATA file is created only when the OPTION 
WRITEDRCDATA command is used, and the FILEIODATA file is created only when 
the OPTION WRITEIODATA command is used. 

LOGGER generates reports during the second phase of operation by reading data from 
the files created in the first phase. During any run, LOGGER generates a report based 
on only one of the files. When instructed, LOGGER can bypass the first operational 
phase by generating reports using files created during previous runs. LOGGER can also 
generate reports using files covering a range of dates (for example, all JOBSUMMARY 
files created during one week). 

The following WFL job can be used to run LOGGER: 

BEGIN JOB; 

RUN SYSTEM/LOGGER; 

<input records> 
END JOB 



8—2 
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LOGGER 



<input records> 



r • 

1 — 1 — <i n 



<in spec> — j 



spec>- 



h — <rep speo — i 
-I— <rep speo L 



r<— <m speo — I 
— I— <in spec> L 



<in spec> 

— <i nput-speci f i cati on command>- 



<rep spec> 

— <report-speci f i cati on command>- 



The following text describes the meaning of each variable: 
< input records > 



< input-specification command> 
< report-specification command > 



Determines which information is used to generate a 
report and where the information comes from. 

If < input records > is not specified, a report is not 
generated. However, LOGGER still creates the 
JOBSUMMARY and STATISTICS files. 

Described in "Input-Specification Commands" in this 
section. 

Described in "Report-Specification Commands" in this 
section. 



Example 

The following WFL job generates a report based on SYSTEM/SUMLOG because a 
SOURCE command is not present. Refer to "SOURCE Command" in this section for 
more information. 



BEGIN JOB; 

RUN SYSTEM/ LOGGER; DATA CARD 

REPORT 1 
END JOB 



LOGGER Input 

LOGGER input consists of input-specification and report-specification commands. 

Each of the LOGGER command listings in this section features the following four 
levels of description: 

• A brief introductory description explaining the function of the command and each 
of its specific applications 

• A syntax diagram outlining the various options of the command 

• An explanation section describing each of the syntax options 

• Examples showing possible command combinations and the results that 
combination will produce 
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LOGGER 



Input-Specification Commands 

The following input-specification commands can be used as input to LOGGER. 
<i nput-speci f i cati on command> 

correction command> j 1 

— <maxrecords command> 

— <option command> 

— <sort parameters command>— 

— <stop command> 

— <use command> 



CORRECTION Command 

Use the CORRECTION command to correct values in a report if the log contains 
erroneous data for an entry. Only reports generated from the JOBSUMMARY file can 
have corrections applied to them. 

This command must follow any report-specification commands, 
correction command> 

— CORRECTION — <mm/dd> — <time> — <mix number> — <item> — = — <number> 1 

<mix number> 

— L/4\-<integer>— 1 1 

The following text describes the meaning of each variable: 

<mm/dd> Specifies the date, mm specifies the month in a 

2-digit form; dd specifies the day in a 2-digit form. 
The delimiter must be a slash (/). 

<time> Specifies the time to the previous hour in the form of 

<hh>. 

This option is required because the same mix number 
can occur more than once in the same day. 

<mix number> Any valid mix number. 

<item> = <number> Any valid numeric JOBSUMMARY file data item. Refer 

to "File Data Items" in this section for more 
information. 

Examples 

The following command replaces the processor time for task 1234 dated 09/01 with the 
value 2.54: 

CORRECTION 09/01 09 1234 PROCESSTIME = 2.54. 

The following command replaces the I/O time for task 7245 dated 08/24 with the value 
1.72: 

CORRECTION 08/24 00 7245 IOTIME = 1.72. 



8-4 
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MAXRECORDS Command 



Use the MAXRECORDS command to specify the maximum number of log records to be 
read. This command can appear before or after a report-specification command. If no 
MAXRECORDS command is entered, the maximum number of log records to be read is 
1,000,000,000. 

<maxrecords command> 

— MAXRECORDS — <integer> 1 



The following text describes the meaning of the variable: 
<integer> Specifies the number of log records to be read. 

Example 

The following example specifies that a maximum of 45,000 log records are to be read: 
MAXRECORDS 45000 



OPTION Command 



Use the OPTION command to enable certain options. All options are disenabled by 
default. This command can appear before or after the report-specification commands. 

<option command> 



OPTION 



/1\- WRITEIODATA - 
-/1\- WRITEDRCDATA - 
DRC0NLY 

/1\- RESETDRC 

-/1\- DEBUG 

-/1\- UPDATE 

/1\- YEAR 



The following text describes the meaning of each variable: 

WRITEIODATA Creates the FILEIODATA file. 

WRITEIODATA is also TRUE if the SOURCE FILE IS FILEIODATA command 
appears in the report-specification commands. Refer to "SOURCE 
Command" for more information. The FILEIODATA file is not created if the 
USE CURRENT command appears in the input-specification commands. 
Refer to "USE Command" for more information. 

WRITEDRCDATA Creates the DRCDATA file. LOGGER creates this file using the disk resource 
control (DRC) information contained in the USERDATAFILE. The DRCDATA 
file is also created if the SOURCE report -specification command specifies 
that the DRCDATA file is to be used to generate the report. 

DRCONLY Prevents LOGGER from processing any system log files. LOGGER collects 

only disk resource control (DRC) data when this option is used, and any 
requests for JOBSUMMARY, STATISTICS, or FILEIODATA reports generate 
syntax errors. 

continued 



8600 0478-100 



8-5 



LOGGER 



continued 

RESETDRC Causes LOGGER to reset the MBYTEDAYS value to zero for all disk resource 

control (DRC) system users who have DRC entries in the USERDATAFILE. 
MBYTEDAYS is explained in Table 8-4 "DRC DATA File Data Items" later in 
this section. 

Note If LOGGER is run with the RESETDRC option set, the 
value of MBYTEDAYS is set to zero for every packname 
entry currently in use by every usercode. This causes 
MBYTEDAYS to start accumulating statistics from zero 
again. For example, if LOGGER is run weekly with the 
RESETDRC option set, each run reports the disk space 
usage for the previous week, sets the value of 
MBYTEDAYS to zero, and then accumulates statistics 
until the next LOGGER run. 

When LOGGER has finished generating the reports and 
files, it sets its TASKVALUE task attribute to a value of 
1. If the RESETDRC option was specified, the 
TASKVALUE task attribute is set before LOGGER starts 
setting the MBYTEDAYS values back to 0. You can use 
the TASKVALUE task attribute in a WFL job to recover 
properly the data generated by LOGGER should your 
system fail. The job can prevent LOGGER from 
restarting from the beginning and reporting 
MBYTEDAYS values that have already been reset to zero. 
An example of a WFL job that uses the TASKVALUE task 
attribute in recovery is given later under this heading. 

DEBUG Prints certain debugging information. 

UPDATE Updates the year-to-date file with the results of the current run. If no 

year-to-date file exists, UPDATE creates one. Report-specification 
commands must be present when this option is used. 

YEAR Generates a year-to-date report from the year-to-date file. After producing 

this report, LOGGER terminates the run and performs no other LOGGER 
updates or report generation. Because the format of the year-to-date report 
is inherent in the file, report-specification commands are not needed when 
using this option. 

Examples 

*un~.„;~ ™, 1 ui — tyct>tt/-< 1 t TTrn a m-m — j.- — „. 

OPTION DEBUG UPDATE 

The following is an example of a WFL job that can be used to restart LOGGER for a 
DRC report with the RESETDRC option set. This example is not complete and must be 
modified for individual systems. For information about issues involved in recovery, 
refer to the discussion of the RESETDRC option earlier under this heading. 
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BEGIN JOB LOGGER/DRC; 
TASK T; 

BOOLEAN RESETONLY; 
SUBROUTINE SETDRC; 
BEGIN 

RUN SYSTEM/LOGGER; 
DATA 

OPTION DRCONLY RESETDRC 
?%END 

END; %SUBROUTINE 
ON RESTART, 
BEGIN 

IF RESETONLY THEN 

BEGIN 

SETDRC; 

GO ENDOFJOB; 

END 
ELSE 

GO JOBSTART; 

END; 

JOBSTART: 

PROCESS RUN SYSTEM/ LOGGER [T] ; 
DATA 

OPTION RESETDRC 
SOURCE IS DRCDATA 

REPORT USERCODE, PACKNAME, DISKINUSE, MBYTEDAYS 
SORT BY USERCODE ASCENDING 
REPORTS ARE SUMMARY 1 
?%END DATA 

WAIT(T(VALUE)=1); 
RESETONLY := TRUE; 
ENDOFJOB: 
END JOB 



SORT PARAMETERS Command 

Use the SORT PARAMETERS command to change the parameters used by the SORT 
command when sorting the entries. 

<sort parameters command> 



— SORT — PARAMETERS -L-r-fW- DISKSIZE — <integer>- 1 — ' 1 

L /l\- TAPES — <integer> 1 

The following text describes the meaning of each variable: 

DISKSIZE <integer> Specifies the maximum amount of disk to be used for the sort. 

The default is 180 million words. 

Note: The <integer> in the DISKSIZE option 

specifies the size in units of words, not sectors. 
A sector typically contains 30 words. 

continued 
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TAPES <integer> Specifies the number of tapes to be used for the sort. The 

default is 3. The number of tapes specified can range from 0 
through 8. However, if the number of tapes is 1, 2, or 3, three 
tapes are used. 

Example 

The following command sets the disk size to 3,600,000 words and specifies that no 
tapes are to be used: 

SORT PARAMETERS DISKSIZE 3600000 TAPES 0 



STOP Command 



Use the STOP command to indicate the end of the LOGGER input. LOGGER does not 
read any input-specification or report-specification commands specified after the STOP 
command. This command should be the last entry in the LOGGER input. 

<stop command> 

_ STOP 1 



USE Command 



The USE command specifies which source files are to be used for the 
LOGGER report. If you do not specify the USE command, LOGGER uses 
the current SYSTEM/SUMLOG on the current log family as the source file. 
LOGGER can access a SUMLOG file only if the log file title has the form 
SUMLOG/< system serial number >/<date>/<log number>, which is the form 
assigned to it automatically by the system during a log release process. 

LOGGER accesses SUMLOG files through the SDASUPPORT library. Depending 
on the security status of the SUMLOG file and the privilege status of the usercode 
running LOGGER, the SDASUPPORT library might perform log filtering. For further 
information about log filtering, refer to Section 12, "SUMLOG." 

The USE command can only appear once in an input deck. This command can appear 
before or after a report-specification command. 



<use command> 



USE 



CURRENT 



SUMLOG -J L-^mddyy^ 

!— <mmddyy; 



L- SYSTEM/SUMLOG 



8-8 



8600 0478-110 



LOGGER 



The following text describes the meaning of each variable: 
SUM LOG <mmddyy> 



SUMLOG <mmddyy> 
<mmddyy> 



SUMLOG CURRENT 
CURRENT 

<mmddyy> 

<mmddyy> <mmddyy> 



Indicates that system logs released through a TL (Transfer Log) 
system command are to be used as the source files. Refer to the 
System Commands Reference Manual for additional information 
about the TL command. 

If two <mmddyy> dates are specified, the files between those 
dates, inclusive, are used. 

Same as SUMLOG <mmddyy>, where <mmddyy> is the 
current date. 

Indicates that the JOBSUMMARY, STATISTICS, DRCDATA, or 
FILEIODATA file with the current date is to be used as the source 
file. New files are not created. 



Use any valid date where mm is the month, dd is the day, and 
yy is the year. 

This form of the command specifies that the JOBSUMMARY, 
STATISTICS, DRCDATA, or FILEIODATA file from the specified 
date is used. 

If two <mmddyy> dates are specified, the files between those 
dates, inclusive, are used. 



SYSTEM/SUMLOG 



Indicates SYSTEM/SUMLOG is to be used as the source file. 



Example 

The following command specifies that SUMLOG files dated with 030281 are to be used 
as source files: 

USE SUMLOG 030281 



Report-Specification Commands 

The report-specification commands specify the format and content of reports. 

Only the first 72 characters of an input record are used for report-specification 
commands. A hyphen (-) used after text and before column 72 indicates that the 
following input record is a continuation of the current command. 

Additional examples that demonstrate the effect of combining certain 
report-specification commands, are provided in "Report-Specification Command 
Examples" in this section. 

The following report-specification commands can be used as input to LOGGER. 
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<report-specifi cation command* 

<break command> 1 1 

— <end command> 

— <exclude command> 

— <heading command* 

— <include command* 

— <output command* 

— <page size command*— 

— <report command* 

— <reports command* 

-<sort command* 

L-<source command* ' 



BREAK Command 



Use the BREAK command to specify where to break to calculate and print the 
requested totals and averages. 

<break command* 

— BREAK -i r— L<i tem*^—, . 1 

L- ON — I <break options*-! 



<break options* 

rWl\ 

1-/1\- TOTALING — i— L<item*^L 

L /l\- AVERAGING - 1 



The following text describes the meaning of each variable: 

<item> Indicates a valid JOBSUMMARY, STATISTICS, DRCDATA, or 

FILEIODATAfile data item. Refer to "File Data Items" in this 
section for more information. 

When more than one file data item is specified, the items are 
taken in order from left to right with the rightmost item 
specifying the innermost break. 

< break options> The specified totals or averages or both are accumulated and 

printed each time the value of the break item changes. 

Both totaling and averaging can be performed on the same item 
in the same detail report. Either totaling or averaging can be 
performed on an item in a SUMMARY or YTD report. If both 
totaling and averaging are specified for the same item in a 
SUMMARY or YTD report, only the totals are printed. 



Examples 



The following command specifies the NAME file data item as a control break: 



BREAK ON NAME 
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The following command specifies totals for TASKS, JOBS, and HL to be printed for the 
DATE file data item each time the value of the item changes: 

BREAK ON DATE TOTALING TASKS, JOBS, HL 



The following command specifies totals for PROCESSTIME and IOTIME and averages 
for IOTIME be printed for the USERCODE file data item each time the value of the 
item changes: 

BREAK ON USERCODE TOTALING PROCESSTIME, IOTIME AVERAGING IOTIME 



END Command 

Use the END command to indicate the end of the report-specification commands. This 
command must appear at the end of the report-specification commands. 

<end command> 

_ END 1 



EXCLUDE Command 



Use the EXCLUDE command to specify the records that are to be excluded from 
the report. As many EXCLUDE commands as desired can appear in the report 
specifications. Excluded items are ORed. When the EXCLUDE and INCLUDE 
commands are used together, the results are ANDed. Refer to "INCLUDE Command" 
for more information. 



<exclude command> 

— EXCLUDE -i [—, |-<item 

L RECORD - 1 I— ip —I 



p<i nteger> r 

I— <quoted string^ 



NEQ - 
LEQ - 
' — GEQ -J 

The following text describes the meaning of each variable: 

<item> Specifies a valid JOBSUMMARY, STATISTICS, DRCDATA, or 

FILEIODATAfile data item. Refer to "File Data Items" in this 
section for more information. 

For items of type string, the length of the comparison made to 
select records is the minimum of the length of the quoted string 
and the actual length of the item. 

= Excludes all items equal to the integer or quoted string from the 

report. 

> Excludes all items greater than the integer or quoted string from 

the report. 

< Excludes all items less than the integer or quoted string from the 

report. 

continued 
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NEQ Excludes all items not equal to the integer or quoted string from 

the report. 

LEQ Excludes all items less than or equal to the integer or quoted 

string from the report. 

GEQ Excludes all items greater than or equal to the integer or quoted 

string from the report. 

<integer> Any valid real or integer number corresponding to a numeric file 

data item. 

<quoted string> A quoted string is data enclosed in quotation marks. The syntax 

is similar to an ALGOL quoted string not a WFL quoted string. 
The data can be null, and the data can contain quotation marks. 
Two successive quotation marks signify a null string, and three 
quotation marks signify a quotation mark within a quoted string. 
Quotation marks can be single (') or double (") as long as the 
beginning and end pair match. Embedded quotations must use 
quotation marks that are not the same as the delimiter quotation 
marks. For example, "A 'quotation' in the string 9 is valid. 
Quoted strings cannot be continued to the next input record. 



Examples 

The following command specifies that only records with the usercode MAVO are to be 
printed in the report: 

EXCLUDE RECORD IF USERCODE NEQ "MAVO" 

The following command specifies that all records with the chargecode SKIP are to be 
excluded from the report: 

EXCLUDE IF CHARGECODE = "SKIP" 

The following command specifies that all records with the queue number 7 are to be 
excluded from the report. Note that the QUEUE data item is padded with leading zeros 
to make its length three digits. 

EXCLUDE IF QUEUE = "007" 

HEADING Command 

Use the HEADING command to specify the heading that appears at the top center 
of each page. If more than one HEADING command is present in the report 
specifications, only the last one is used. 

<heading command> 

— HEADING — 1 r- <quoted stn"ng> 1 

I— IS -J 
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The following text describes the meaning of the variable: 

<quoted string> A quoted string is data enclosed in quotation marks. The syntax 

is similar to an ALGOL quoted string, not a WFL quoted string. 
The data can be null, and the data can contain quotation marks. 
Two successive quotation marks signify a null string, and three 
quotation marks signify a quotation mark within a quoted string. 
Quotation marks can be single (') or double (") as long as the 
beginning and end pair match. Embedded quotations must use 
quotation marks that are not the same as the delimiter quotation 
marks. For example, "A 'quotation' in the string" is valid. 
Quoted strings cannot be continued to the next input record. 

Example 

The following command places the heading JOB -TASK-SESSION BY USERCODE at 
the top center of each page of the report: 

HEADING IS "JOB-TASK-SESSION BY USERCODE" 



INCLUDE Command 



Use the INCLUDE command to indicate what records are to be included in the 
report. Any item not specified in this command is excluded from the report. As many 
INCLUDE commands as desired can appear in the report-specification commands. 
Items that are included are ORed. When INCLUDE and EXCLUDE commands are 
used together, the results are ANDed. Refer to "EXCLUDE Command" for more 
information. 



<include command> 

— INCLUDE -, 1 — I r-<item> 

L RECORD —I I— if —J 



C<i nteger> r- 
<quoted string>— J 



NEQ 
- LEQ H 
L GEQ 

The following text describes the meaning of each variable: 

<item> Specifies a valid JOBSUMMARY, STATISTICS, DRCDATA, or 

FILEIODATA file data item. Refer to "File Data Items" in this 
section for more information. 

For items of type string, the length of the comparison made to 
select records is the minimum of the length of the quoted string 
and the actual length of the item. 

= Includes the items equal to the integer or quoted string. 

> Includes the items greater than the integer or quoted string. 

< Includes the items less than the integer or quoted string. 

NEQ Includes the items not equal to the integer or quoted string. 

LEQ Includes the items less than or equal to the integer or quoted 

string. 



continued 
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GEQ Includes the items greater than or equal to the integer or quoted 

string. 

<integer> Any valid real or integer number corresponding to numeric file 

data items. 

<quoted string> A quoted string is data enclosed in quotation marks. The syntax 

is similar to an ALGOL quoted string, not a WFL quoted string. 
The data can be null, and the data can contain quotation marks. 
Two successive quotation marks signify a null string, and three 
quotation marks signify a quotation mark within a quoted string. 
Quotation marks can be single (') or double (") as long as the 
beginning and end pair match. Embedded quotations must use 
quotation marks that are not the same as the delimiter quotation 
marks. For example, "A 'quotation' in the string" is valid. 
Quoted strings cannot be continued to the next input record. 

Examples 

The following command specifies that only records with the date 02/23/82 are to be 
included in the report: 

INCLUDE RECORD IF DATE = "02/23/82" 

The following command specifies that only records with the type J are to be included in 
the report: 

INCLUDE IF TYPE = "J" 

The following command specifies that only records with the queue number 7 are to be 
included in the report. Note that the QUEUE data item is padded with leading zeros to 
make its length three digits. 

INCLUDE IF QUEUE = "007" 

OUTPUT Command 

Use the OUTPUT command to specify items that are to appear in the report. 
<output command> 

_ OUTPUT -I t-t r-L- <item>~I] 1 

U ITEMS - 1 L_ ARE — » 

The following text describes the meaning of the variable: 

<item> Specifies a valid JOBSUMMARY, STATISTICS, DRCDATA, or FILEIODATA 

file data item. Refer to "File Data Items" in this section for more 
information. 
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Example 

The following command specifies that the TYPE, MIXNO, JOBNO, and 
PROCESSTIME file data items are to appear in the report. Because these items 
are all valid JOBSUMMARY file data items, it is assumed that a SOURCE FILE IS 
JOBSUMMARY command is present in the report specifications. Refer to "SOURCE 
Command" for more information. 

OUTPUT ITEMS ARE TYPE, MIXNO, JOBNO, PROCESSTIME 

PAGE SIZE Command 

Use the PAGE SIZE command to specify the number of lines per page for the report. If 
no PAGE SIZE command is entered, the number of lines per page is 60. 

<page size command> 

— PAGE — I i—i r-<integer> 1 

L- SIZE — ' ' — IS — ' 

The following text describes the meaning of the variable: 
<integer> Indicates the number of lines on a page. 

Example 

The following command specifies that each page of the report will contain 72 lines: 
PAGE SIZE IS 72 



REPORT Command 

Use the REPORT command to indicate the beginning of the report specifications. This 
command can only appear once in the input deck. 

<report command> 

— REPORT -| 1 1 

I— <integer>— ' 

The following text describes the meaning of the variable: 

<integer> Identifies the number of the report in the LOGREPORTS file. The 

LOG REPORTS file can contain many report specifications and is used for 
installation convenience. Refer to "REPORT Commands and LOGREPORTS 
File" in this section for more information. 

Example 

The following command specifies that the report specifications for the report are to be 
found in the LOGREPORTS file under report number 4: 

REPORT 4 
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REPORTS Command 



Use the REPORTS command to specify whether the type of report to be printed is a 
detailed report, summary report, or both. 

If this command is not present in the report specifications, a detailed report is 
produced. 

<reports command> 
— REPORTS 



L ARF J L 



DETAILED 



3 



SUMMARY — <integer>- 



The following text describes the meaning of each variable 
DETAILED 



SUMMARY <integer> 



Specifies one detailed report. A detailed report includes one line 
for each record in the file. 

Specifies one summary report. A summary report consists of one 
line for a particular group of records in the file. If summary 
reports are requested, the REPORTS command must be 
preceded by at least as many BREAK commands as there are 
summary reports to be printed. Refer to "BREAK Command" in 
this section for more information. 

The integer indicates the control break item to be summarized 
when more than one BREAK command is specified in the report 
specifications. 



Examples 

The following command specifies a summary report with totals to be generated for the 
control break item specified in the second BREAK command: 

REPORTS ARE DETAILED SUMMARY 2 

The following command specifies a summary report to be generated for the control 
break items specified in the first and second BREAK commands: 

REPORTS ARE DETAILED SUMMARY 1 SUMMARY 2 



SORT Command 



Use the SORT command to specify the sort sequence for the output items. 
<sort command> 



r< 

SORT -, r— <item> 

L- BY 



ASCENDING 
DESCENDING 



3 
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The following text describes the meaning of each variable: 

<item> Specifies a valid JOBSUMMARY, STATISTICS, DRCDATA, or FILEIODATA 

file data item. Refer to "File Data Items" in this section for more 
information. 

If more than one item is specified, sorting begins with the first item. When 
the first item is equal, the sort moves to the next item and continues in 
order until all items are sorted. 

ASCENDING Sorts the items from the lowest to the highest order. The default order is 

ASCENDING. 

DESCENDING Sorts the items from the highest to the lowest order. 
Examples 

The following command indicates the report is to be sorted by job number in ascending 
order: 

SORT BY JOBNO ASCENDING 

The following command indicates the report is to be sorted in in ascending order first 
by usercode, and then by mix number, within each usercode: 

SORT BY USERCODE, MIXNO 



SOURCE Command 



Use the SOURCE command to specify whether a JOBSUMMARY, STATISTICS, 
DRCDATA, or FILEIODATA file is to be used to generate the report. Only one 
SOURCE command can appear in the input deck. This command must precede all 
other report-specification commands except the REPORT command. 



<source command> 
— SOURCE 



L FILE -J L IS -J _ 



JOBSUMMARY 
STATISTICS -| 
DRCDATA — 



FILEIODATA 



The following text describes the meaning of each variable: 

JOBSUMMARY Indicates a JOBSUMMARY file is to be used to generate the report. 
STATISTICS Indicates a STATISTICS file is to be used to generate the report. 

DRCDATA Indicates a DRCDATA file is to be used to generate the report. 

FILEIODATA Indicates a FILEIODATA file is to be used to generate the report. 
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Example 

The following command indicates the FILEIODATA file is to be used to generate the 
report. This command also enables the WRITEIODATA option. Refer to "OPTION 
Command" in this section for more information. 

SOURCE FILE IS FILEIODATA 

Report-Specification Command Examples 

The following examples illustrate the use of report-specification commands. Detailed 
explanations of the individual commands are in "Report-Specification Commands" in 
this section. A sample of the report produced by each example is shown in Figures 8-1 
through 8-8. 

Example 1 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the JOBSUMMARY file as the source 
of information for the report. The OUTPUT command selects the TYPE, MIXNO, 
JOBNO, NAME, PRIORITY, ORGUNIT, CHARGECODE, PROCESSTIME, and 
IOTIME file data items to be printed. The END command signifies the end of the 
report-specification commands. 

REPORT 

SOURCE IS JOBSUMMARY 

OUTPUT ITEMS ARE TYPE, MIXNO, JOBNO, NAME, PRIORITY, ORGUNIT, - 

CHARGECODE, PROCESSTIME, IOTIME 
END 

Figure 8-1 shows the resulting report. 
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NAME 

(WBJ)OBJECT/S/TASK/CHARGECODE 
WBJ)OBJECT/S/TASK/CHARGECOOE/ 
(WBJ]OBJECT/S/TASK/CHARGECODE 

UPDATE FAULTLOG . 
"UPOATE-FAULTLOG". 
""• OBJECT/S/TASK/CHARGECODE/ 
OBJECT/S/TASK/CHARGECODE/ 
08 JECT/S/TASK/UT I L/L 1 BRAR 
OBJECT/S/TASK/CHARGECODE/ 
08 JECT/S/TASK/UT IL/L I BRAR 
OB JECT/S/TASK/UT IL/L I BRAR 
, ._ -M/FAULTLOGGER. 

BEGIN JOB-.RUN SYS" . 
SYSTEM/FAULTLOGGER. 
"BEGIN JOB;RUN SYS" . 
(WBJjOBJECt/S/TASK/CHARGECOOE 
SYSTEM/PATCH. 
SYSTEM/ALGOL. 
SYSTEM/PATCH. 
SYSTEM/ALGOL. 
WBJjOBJECT/S/TASK/CONVENTlON 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OB JECT/S/TASK/UT IL/L I BRAR 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OB JECT/S/TASK/UT IL/L I 8RAR 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION 
-M/PATCH. 
SYSTEM/ALGOL. 
SYSTEM/PATCH. 
'YSTEM/ALGOL. 

O8JECT/S/TASK/0ESTNAME ON 
OBJECT/S/TASK/OESTNAME ON 
OBJECT/S/TASK/OESTNAME/EX 
OBJECT/S/TASK/DESTNAME/EX 
OBJECT/S/TASK/OESTNAME/EX 
OBJECT/S/TASK/OESTNAME ON 
OBJECT/S/TASK/DESTNAME ON 



WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
W8J 
WBJ 
.WBJ 
$YST 



WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 
WBJ 



PRIORITY 

50 
50 
50 
80 
80 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
SO 
50 
50 
50 
SO 
50 
50 
50 
50 
50 
50 
50 
50 



ORGUNIT 



LSN 
LSN 
LSN 
UNIT 
UNIT 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
UNIT 
UNIT 
UNIT 
UNIT 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 



.00602 
: 00602 
: 00602 
: 00000 
: 00000 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00000 
: 00000 
: 00000 
: 00000 
: 00602 
: 00602 
.00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
.00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
-.00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
.00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 
: 00602 



CHARGECODE 

CHARGE. 
CHARGE. 
CHARGE. 



CHARGE. 

CHARGE. 

CHARGE. 

CHARGE. 

6685. 

6685. 



6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 
6685. 



PROCESSTIME 

0.01 
0.01 
0.01 
0.02 
0.02 
0.01 
0.01 
0.08 
0.01 
0.04 
0.04 
0.04 
0.03 
0.03 
0.03 
0.25 
0.30 
0.85 
0.30 
0.67 
0.01 
0.01 



0.01 
0.01 
0.08 
0.01 
0.40 
0.01 
0.01 
0.01 
0.01 
0.01 
0.01 
0.01 
0.01 
0.01 
0.08 
0.01 
0.43 
0.30 
0.80 
0.30 
0.67 
0.01 
0.01 
0.01 
0.01 
0.02 
0.01 
0.01 



IOTIME 

0.00 
0.05 
0.00 
0.07 
0.00 
0.03 

»:§§ 



0.11 
0.13 
1.24 
1.08 
1.19 
0.91 
0.00 
0.00 
0.00 
0.00 
0.03 
0.00 
0.00 
0.00 
0.00 
0.04 
0.09 
0.19 
0.05 
0.04 
0.05 
0.04 
0.03 
0.04 
0.04 
0.01 
0.01 
0.14 
0.04 
0.97 
1.28 
1.14 
1.17 
1.04 
0.00 



0.00 
0.00 



LOGGER 



Example 2 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the JOBSUMMARY file as the source 
of information for the report. The HEADING command specifies LOG SORTED BY 
TIME to be used as the heading for the report. 

The SORT command specifies that the report is sorted by the STARTTIME file data 
item. The OUTPUT command selects the MIXNO, TYPE, STARTTIME, NAME, 
USERCODE, PRIORITY, ELAPSEDTIME, and TERMCOND file data items to be 
printed. The END command signifies the end of the report-specification commands. 

REPORT 

SOURCE FILE IS JOBSUMMARY 
HEADING IS "LOG SORTED BY TIME" 
SORT BY STARTTIME 

OUTPUT ITEMS ARE MIXNO, TYPE, STARTTIME, NAME, USERCODE, - 

PRIORITY, ELAPSEDTIME, TERMCOND 
END 



Figure 8-2 shows the resulting report. 
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LOG SORTED BY T I ME 
04/04/90 



HIXNO 



TYPE STARTTIME 



J 08 


12 : 


S 10 


41 : 




4 


40 : 




5 


07 : 




5 


12 : 




5 


13 : 




5 


13 : 




5 


13 : 




5 


13 : 




5 


14 : 




5 


14 : 




5 


14 : 




5 


14 : 




5 


1 A . 

14 : 




5 


14 : 




5 


1 A ■ 

n : 




5 


1 A . 




5 


14 : 




5 


1 A . 

14 : 




5 


1 A . 

14 : 




5 


14 : 




5 


14 : 




5 


1 A M 

14 




5 


14 . 




15 


1 A ■ 

n : 




c 
0 


lb . 




5 


1 D 




5 


15 • 




5 


IS: 




5 


15. 




5 


15- 




5 


15: 




.5 


15: 


T 


5 


15: 


T 


5 


15- 


T 


5 


15: 


T 


15 


15: 


J 


5 


15: 


T 


5 


15: 


T 


5 


15: 


J 


15 


15: 


T 


5 


15: 


T 


5 


15: 


T 


5 


15: 


T 


5 


15: 


T 


5 


15: 


T 


5 


15: 


T 


5 


15: 


J 


5 


15: 


T 


5 


15: 


T 


5 


15: 


T 


5 


15: 


J 


5 


15: 


T 




15: 




11 


15: 



NAME 

( LEEL ]SYSTEM/RUNMAIL ON PACK . 
-MCS SESSION- 
OBJECT/ED. 

STATUS/CHANGE/LFA15CD. 
OBJECT/EO ON MCPHAST. 
"ASKTEST . 

ACWAN J08JECT/TESTDCS ON DC. 

ACWAN DATAC0MSUPP0RT/9. 

ACWANjOBJECT/DCS/PATCH ON DC. 

W8F )OBJECT/S/T ASK/CHARGE CODE 

'UPDATE-FAULTLOG". 



WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 



0B3ECT/S/TASK/CHARGECODE 
OBJECT/S/TASK/CHARGECODE/ 
OBJECT/S/ TASK /CHARGE CODE 
OBJECT/S/TASK/CHARGECOOE/ 
OBJECT/S/ TASK/CHARGECODE/ 
08JECT/S/TASK/UT IL/L i BRAR 
OBJECT/ S/TASK/UT I L/L I BRAR 
OBJECT/S/TASK/CHARGECODE/ 



1DI UDvtu 1 / Of m^N/ 

SYSTEM/FAULTLOGGER. 
"BEGIN JOB;RUN SYS" 
SYSTEM/FAULTLOGGER. 

BEGIN JOB :RUN SYS". 
SYSTEM/PATCH. 
SYSTEM/ALGOL. 
SYSTEM/PATCH. 
SYSTEM/ALGOL. 

OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION/ 



WBF 
WBF 
WBF 
WBF 
WBF 
W8F 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
WBF 
W8F 



OBJECT/S/TASK/CONVENTION/ 
08JECT/ S/TASK/UT I L/L I BRAR 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CONVENTION 
O&^CT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/ TASK/ CONVENT ION 
OBJECT/S/TASK/CONVENTION 
OBJECT/S/TASK/CON VENT ION/ 
OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION 
08 JECT/S/ TASK /CON VENT ION 
OBJECT/S/TASK/CONVENTION/ 
28JEa/^aASK^yiIL|L18RAR 



OBJECT/S/TASK/CONVENTION/ 
OBJECT/S/TASK/CONVENTION/ 
JlHl """/CONVENT.ON/ 
SYSTEM/ALGOL. 



USERCODE 


PRIORITY 


ELAPSEDTI 


HE 


JBCOXX. 








PWTODD. 


00 


291. 


49 


ACWAN. 




DUNKINS. 


75 


18. 


94 








WBF . 


50 


20. 


96 


ACWAN . 


50 


10. 


98 


ACWAN. 


50 


10. 


96 


ACWAN. 


50 


10. 


97 


WBF . 


50 


0. 


32 


WBF . 


50 


0. 


04 




80 


0. 


00 


WBF . 


80 


0. 


00 


50 


0. 


00 


WBF . 


50 


0 


00 


WBF . 


50 


0. 


00 


WBF . 


50 


0. 


00 


WBF . 


50 


0 


00 


WBF . 


50 


0 


00 


WBF . 


50 


0 


00 


WBF . 


50 


0 


00 




50 


0 


00 




50 


0 


01 




50 


0 


00 


WBF . 


50 


0 


01 


50 


0 


03 


WBF . 


50 


0 


04 


WBF . 


50 


0 


03 


WBF . 


50 


0 


03 


unr 
Wor . 


50 


0 . 


26 


WBF. 


50 


0 


00 


WBF. 


50 


0 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


04 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


29 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF . 


50 


0. 


05 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


00 


WBF. 


50 


0. 


03 


WBF. 


50 


0. 


04 



TERMCOND 



P-DSED 
P-DSED 
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Example 3 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the JOBSUMMARY file as the source of 
information for the report. 

The BREAK command specifies the USERCODE file data item to act as a control 
break. Each usercode is printed on a separate line every time the value of the control 
break item changes. 

The SORT command specifies sorting by more than one file data item. The output is 
sorted in ascending order first by USERCODE and then by MIXNO. 

The OUTPUT command selects the TYPE, MIXNO, NAME, LINES, AVGCORECODE, 
AVGCOREDATA, DATE, PRIORITY, and ORGUNIT file data items to be printed. 

The HEADING command causes the heading JOB/TASK/SESSION SUMMARY BY 
USERCODE to be printed at the top of every page. The PAGE SIZE command specifies 
that 56 lines are to be printed on each page. The END command signifies the end of 
the report-specification commands. 

REPORT 

SOURCE FILE IS JOBSUMMARY 

BREAK ON USERCODE 

SORT BY USERCODE, MIXNO ASCENDING 

OUTPUT ITEMS ARE TYPE, MIXNO, NAME, LINES, AVGCORECODE, - 

AVGCOREDATA, DATE, PRIORITY, ORGUNIT 
HEADING IS "JOB/TASK/SESSION SUMMARY BY USERCODE" 
PAGE SIZE IS 56 
END 

Figure 8-3 shows the resulting report. 
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8600 0478-100 



TYPE HIXNO NAME 



JOB/TASK/SESSION SUMMARY BY USERCODE 
04/04/90 

LINES AVGCORECODE AVGCOREOATA OATE 



PRIORITY 



ORGUNIT 



USERCOOE: 

0108 
0109 
0120 



KLM 
KLM 
KLM 
KLM 
KLM 
KLM 
BEG 



0519 
0539 
0601 
0613 
0630 
0712 



KLM) OBJECT/SYMBOL/OK I /TRANSFO 
KLM ) OBJECT/SYMBOL/OK I /TRANSFO 
KLMJOBJECT/SYMBOL/OKI/TRANSFO 
KLM OBJECT/SYM80L/OKI/TRANSFO 
KLM OBJECT/SYMBOL^OKI/TRANSFO 
BEGIN JOB:RUN SYS . 
SYSTEM/FtUOATA. 
SERVER/LP5/ K R#7511"/"J#0183". 
SERVER/LP5/"R#7512 , 7"J#9989". 
t KLM) OB JECT/SYM80L/0K l/TRANSFO 
OBJECT/SYMBOL/OK I /TRANSFO 
OBJECT/SYMBOL/OK I /TRANSFO 
OBJECT/SYMBOL/OK I /TRANSFO 
OBJECT /SYMBOL/OK I /TRANSFO 

,^.r^§i^ B 2^ oK,/TRAMsFo 

library/maIntenance'. 
klm job ject/symbol/ok i /transfo 
klm) object/symbol/ok i /transfo 

KLM J OBJECT/SYMBOL/OK I /TRANSFO 

klmJobject/symbol/oki/transfo 
klmjobject/symbol/oki/transfo 

KLM J08 JECT/SYMBOL/OK I /TRANSFO 
KLMJOBJECT/SYMBOL/OK I /TRANSFO 
KLMJOBJECT/SYMBOL/OKI/TRANSFO 
KLM j OBJECT/SYMBOL/OK I /TRANSFO 
KLM JOB JECT/SYMBOL/OK I /TRANSFO 
KLM )0B JECT/SYMBOL/OK I /TRANSFO 
KLM {OBJECT/SYMBOL /OK I /TRANSFO 
KLM JOB JECT/SYM80L/0K I /TRANSFO 
KLM OBJECT/SYMBOL/OK I/TRANSFO 
KLM OBJECT/SYMBOL/OK l/TRANSFO 

i KLM J OB JECT/SYMBOL/OK I/TRANSFO 

H/UT LITY/PHONE. 

( KLM JOB JECT/SYMBOL/OK l/TRANSFO 

(KLMjOBJECT/SYMBOL/OK I/TRANSFO 

*8EGlN JOB:RUN SYS ( \ 

SYSTEM/FILE.OATA. 

$inV£R/l.PSrRt7SV"/" JI0500" . 

(KLMJOBJECT/SYMBOL/OKI/TRANSFO 

(KLMJOBJECT/SYMBOL/OKI/TRANSFO 
KLMJOBJECT/SYMBOL/OKI/TRANSFO 

MAIL/REMINDER. 

!UPPRESS/MIX/NOS ON PACK . 
KLM JOB JECT/SYMBOL/OK l/TRANSFO 
KLMJOBJECT/SYMBOL/OKI/TRANSFO 



0 
0 
0 
0 
0 
0 
39 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 



0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 

75 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 



04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 
04/04/90 



LSN 
LSN 
LSN 
LSN 
LSN 
UNIT 
UNIT 
UNIT 
UNIT 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
UNIT 
UNIT 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
LSN 
UNIT 
UNIT 
UNIT 
LSN 
LSN 
LSN 
UNIT 
UNIT 
LSN 
LSN 
LSN 
UNIT 



00488 
00488 
00488 
00488 
00488 
00002 
00002 
00000 
00000 
00488 
00488 
00488 
00488 
00488 
00488 
00002 
00002 
00488 
00488 
00488 



:0048( 
:0048£ 
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Example 4 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the JOBSUMMARY file as the source of 
information for the report. 

The SORT command specifies sorting by more than one file data item. The output is 
sorted in ascending order by NAME, USERCODE, and STARTTIME. 

The BREAK command specifies the NAME file data item to act as a control break. 
Each name is printed on a separate line each time the value of the control break item 
changes. 

The INCLUDE and EXCLUDE commands specify that only MCS sessions and jobs of 
user SITE that do not have a chargecode of SKIP are processed for the report. The 
HEADING command specifies REPORT FOR USERCODE DBH to be used as the 
heading for the report. 

The OUTPUT command selects the TYPE, MIXNO, NAME, LINES, AVGCORECODE, 
AVGCOREDATA, DATE, PRIORITY, and ORGUNIT file data items to be printed. The 
END command signifies the end of the report-specification commands. 

REPORT 

SOURCE JOBSUMMARY 

SORT BY NAME, USERCODE, STARTTIME 

BREAK ON NAME 

INCLUDE RECORD IF TYPE = "S" 
INCLUDE RECORD IF TYPE = "J" 
EXCLUDE RECORD IF USERCODE NEQ "SITE" 
EXCLUDE RECORD IF CHARGECODE = "SKIP" 
HEADING IS "REPORT FOR USERCODE DBH" 

OUTPUT ITEMS ARE TYPE, MIXNO, NAME, STARTTIME, ELAPSEDTIME 
END 

Figure 8-4 shows the resulting report. 
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TYPE MIXNO NAME 



REPORT FOR USERCODE DBH 
04/04/90 



STARTTIME 



ELAPSEDT IME 



NAME: (08H)08JECT/S/TASK/CHARGECO0E/ 



9923 
9933 



( DBH )OBJECT/S/TASK/CHARGE CODE/ 
(D8H)0BJECT/S/TASK/CHAR6ECO0E/ 



NAME: (DBH)0BJECT/S/TASK/C0NVENT10N/ 



9949 
9955 



!DBH)OBJECT/S/TASK/CONVENTION/ 
DBHjOBJECT/S/TASK/CONVENTION/ 



9961 (OBH JOB JECT/S /TASK/CON VENT ION/ 
9967 (OBHjOBJECT/S/TASK/CONVENTION/ 

NAME: (D8H)0BJECT/S/TASK/DESTNAME/EX 



99t 
99f 



(DBH)OBJECT/S/TASK/DESTNAME/EX 
(D8H)0BJECT/S/TASK/DESTNAME/EX 

name: (0bh)0bject/s/task/0isklimit/e 

0100 (obh)object/s/task/dlsklinit/e 

0197 (obh|object/s/task/disklimit/e 

0115 (obhJobject/s/task/oisklimit/e 

0122 (obhJobject/s/task/disklimit/e 

name: (dbh)0bject/s/task/displayonly 



0137 
0143 



(DBH)OBJECT/S/TASK/DlSPLAYONLY 
(0BH)0BJECT/S/TASK/D1SPLAY0NLY 



NAME: (DBH)OBJECT/S/TASK/ELAPSEDLIMI 



0155 
0163 



(OBH)OBJECT/S/TASK/ELAPSEOLIMI 
(OBH)OB JECT/S/T ASK/ELAPSE OL IM I 



NAME: ( OBH )0B JECT/S/T ASK/ELAPSEOTiME 



0175 
0181 



(OBH)OBJECT/S/TASK/ELAPSEDTIME 
(OBH JOB JECT/S/T ASK/ ELAPSEDT IME 



NAME: (DBH)OBJECT/S/TASK/FAMILY/EXTE 



NAME 



0197 
0204 

: ( DBH) OB JECT/S /TASK/ F I LEACCESSR 



(DBH)OB JECT/S/TASK/FAMI LY/EXTE 
(DBH JOBJECT/S/TASK/FAMILY/EXTE 



NAME 



0214 ( DBH JOB JECT/S/TASK/F I LEACCESSR 
0220 {DBh}0BJECT/S/TASK/FI LEACCESSR 

82?? S8 H object/s/task/fileaccessr 

0233 (DBH)0BJECT/S/TASK/FILEACCESSR 

(dbh)object/s/task/iotime/exte 
0244 (dbh)0bject/s/task/10t1me/exte 



15:14:52 
15:14:54 



ION/ 1 
ION/ 1 



15:18 
15:20 
15:35 
15:37 



15:16:01 
15:16:" 



03 



15:16:32 
15:16:37 
15:16:50 
15:16:57 



15:17:31 
15:17:34 



15:18:08 
15:18:10 



15:18:42 
15:18:53 



15:19:18 
15:19:20 



15:19:44 
15:19:47 
15:20:00 
15:20:03 



15:20:26 



0.00 
0.00 



0.00 
0.00 
0.00 
0.00 



0.00 
0.00 



0.01 
0.02 
0.01 
0.02 



0.00 
0.00 



0.02 
0.00 



0.03 
0.03 



0.00 
0.00 



0.00 
0.00 
0.00 
0.01 



0.01 



8600 0478-100 



Figure 8-4. LOGGER Example 4 Output 
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Example 5 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the JOBSUMMARY file as the source of 
information for the report. 

The INCLUDE command specifies that only MCS sessions are processed for the report. 
The SORT command specifies the output to be sorted by the USERCODE file data item. 

The BREAK command specifies that totals be accumulated and printed for 
PROCESSTIME and IOTIME each time the value of the control break item (DATE) 
changes. The HEADING command specifies MCS SESSION SUMMARY to be used as 
the heading for the report. 

The OUTPUT command selects the MIXNO, MCSNAME, LSN, STANAME, 
LOGONREASON, LOGOFFREASON, PROCESSTIME, IOTIME, and STARTTIME 
file data items to be printed. The END command signifies the end of the 
report-specification commands. 

REPORT 

SOURCE IS JOBSUMMARY 
INCLUDE RECORD IF TYPE = "S" 
SORT BY USERCODE 

BREAK ON USERCODE TOTALING PROCESSTIME, IOTIME 
HEADING "MCS SESSION SUMMARY" 

OUTPUT ITEMS ARE MIXNO, MCSNAME, LSN, STANAME, LOGONREASON, - 

LOGOFFREASON, PROCESSTIME, IOTIME, STARTTIME 
END 

Figure 8-5 shows the resulting report. 
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00 
CD 
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Example 6 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the JOBSUMMARY file as the source of 
information for the report. The SORT command specifies the output to be sorted first 
in descending order by the USERCODE file data item, and then in ascending order by 
the NAME file data item. 

The first BREAK command specifies that totals be accumulated and printed for 
PROCESSTIME and IOTIME each time the value of the control break item 
(USERCODE) changes. An average for the elapsed time is also printed. The second 
BREAK command specifies that totals be accumulated and printed for PROCESSTIME, 
IOTIME, MEMINTCODE, and MEMINTDATA each time the value of the control 
break item (NAME) changes. 

The INCLUDE command specifies that only tasks are processed for the report. The 
OUTPUT command selects the MIXNO, PROCESSTIME, IOTIME, CARDSREAD, 
LINES, MEMINTCODE, MEMINTDATA, STARTTIME, and ELAPSEDTIME file data 
items to be printed. The HEADING command specifies PROGRAM SUMMARY BY 
USERCODE to be used as the heading for the report. 

SUMMARY 1 in the REPORTS command causes totals to be printed for the control 
break item specified in the first BREAK command (USERCODE). SUMMARY 2 in the 
REPORTS command causes totals to be printed for the control break item specified 
in the second BREAK command (NAME). The totals generated by the REPORTS 
command are printed immediately after a corresponding dashed line is printed. The 
END command signifies the end of the report-specification commands. 

REPORT 

SOURCE FILE IS JOBSUMMARY 
SORT BY USERCODE DESCENDING, NAME ASCENDING 
BREAK ON USERCODE TOTALING PROCESSTIME, IOTIME AVERAGING- 
ELAPSEDTIME 

BREAK ON NAME TOTALING PROCESSTIME, IOTIME, MEMINTCODE, - 

MEMINTDATA 
INCLUDE RECORD IF TYPE = "T" 

OUTPUT ITEMS ARE MIXNO, PROCESSTIME, IOTIME, CARDSREAD, LINES, - 

MEMINTCODE, MEMINTDATA, STARTTIME, ELAPSEDTIME 
HEADING IS "PROGRAM SUMMARY BY USERCODE" 
REPORTS ARE DETAILED SUMMARY 1 SUMMARY 2 
END 

Figure 8-6 shows the resulting report. 
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PROGRAM SUMMARY BY USERCOOE 
08/07/90 

MIXNO PROCESSTIME IOTIME CAROSREAO LINES MEMINTCODE MEMINTDATA STARTTIME ELAPSEOT IME 

USERCODE: JOANNE. 
NAME: OBJECT/ED ON SYSPK. 

9561 0.63 2.34 0 0 68.58 87.72 12:39*29 26 69 

- - - - TOTALS FOR OBJECT/EO ON SYSPK. - - - . - I - ! I - - 

0.63 2.34 68.58 87.72 

TOTALS FOR JOANNE. - - - - ------ 

0.63 2.34 

- - - - AVERAGES FOR JOANNE. 

26.69 

USERCODE : MARTEN. 

NAME: SYSTEM/ DUMP ANALYZER ON SYSPK. 

9939 11.49 2.15 0 711 366.67 672.58 13:57:51 23.16 

TOTALS FOR SYSTEM/DUMP ANAL YZ ER ON SYSPK. - ------ _i f J : 1 ! 

H-49 2.15 366.67 672.58 

NAME: SYSTEM/F I LEDAT A ON SYSPK. 

8312 0 . 65 0.54 0 0 7.07 14.74 14:39:16 0.76 

0339 , 0.50 0.43 0 n 5.38 11 47 14 : 38 : 28 0 48 

- - - - TOTALS FOR SYSTEM/F I LEOATA ON SYSPK. - - - - - - - - - - l ..: e ° u 

1 .15 0.97 12.45 26 21 

- - - - TOTALS FOR MARTEN. ... - - - - - - 

12.64 3.12 

- - - - AVERAGES FOR MARTEN. - 

8.13 

PROGRAM SUMMARY BY USERCODE 
08/07/90 

SUMMARY REPORT BY USERCODE 

TOTAL TOTAL AVERAGE 

USERCOOE PROCESSTIME IOTIME ELAPSEOT IME t OF RUNS 

JOANNE . 0.63 2.34 26 69 1 

MARTEN . 360.53 74.37 2 ! 1 6 47 

PROGRAM SUMMARY BY USERCODE 
08/07/90 

SUMMARY REPORT BY NAME 

„, ur TOTAL TOTAL TOTAL TOTAL 

NAME PROCESSTIME IOTIME MEMINTCODE MEMINTDATA # OF RUNS 
USERCODE: JOANNE. 

OBJECT/ED ON SYSPK. 0.63 2.34 68.58 87.72 1 
USERCODE: MARTEN. 

SYSTEM/DUMPANALYZER ON SYSPK. 11.49 2.15 366 67 672 58 1 

SYSTEM/F ILEDATA ON SYSPK. 1.15 o!97 12!45 26:21 2 
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Example 7 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the STATISTICS file as the source of 
information for the report. 

The HEADING command specifies SUMMARY STATISTICS to be used as the heading 
for the report. The OUTPUT command selects the TIME, DISK, TAPE, READER, 
REMOTE, MISCFILES, TASKS, JOBS, HL, MAXTASKS, and MAXJOBS file data 
items to be printed. 

The BREAK command specifies that totals be accumulated and printed for DISK, 
TAPE, READER, REMOTE, TASKS, JOBS, and HL each time the value of the 
control break item (DATE) changes. The END command signifies the end of the 
report-specification commands. 

REPORT 

SOURCE FILE IS STATISTICS 
HEADING IS "SUMMARY STATISTICS" 

OUTPUT ITEMS ARE TIME, DISK, TAPE, REMOTE, MISCFILES, - 

TASKS, JOBS, HL, MAXTASKS, MAXJOBS 
BREAK ON DATE TOTALING DISK, TAPE, REMOTE, TASKS, - 

JOBS, HL 
END 



Figure 8-7 shows the resulting report. 
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Example 8 

In the following example, the REPORT command signifies the beginning of the report 
specifications. The SOURCE command selects the FILEIODATA file as the source of 
information for the report. 

The OUTPUT command selects the MLXNO, INTNAME, EXTNAME, USE, KIND, 
FILEKIND, RETENTION, and IOTIME file data items to be printed. The HEADING 
command specifies FILE USAGE REPORT to be used as the heading for the report. 
The END command signifies the end of the report-specification commands. 

REPORT 

SOURCE FILE IS FILEIODATA 

OUTPUT ITEMS ARE MIXNO, INTNAME, EXTNAME, USE, KIND, FILEKIND, - 

RETENTION, IOTIME 
HEADING IS "FILE USAGE REPORT" 
END 



Figure 8-8 shows the resulting report. 



8-32 



8600 0478-100 



FILE USAGE REPORT 
10/09/90 



M1XN0 INTNAHE 



6605 
6605 
6609 
6608 
6609 
6608 
6608 
5577 
5577 
6610 
6610 
6612 
6612 
6612 
6612 
6612 
6612 
6612 
6614 
6614 
6614 
6614 
0898 
0898 
9211 
6616 
6821 
6826 
6821 
6826 
9210 
9210 
9211 
6821 
6626 
6821 
6826 
7595 
7595 
7595 
7595 
7595 
6619 
7595 
7595 
7595 
7595 
7595 
9211 
6622 
6622 
6622 
6622 
6613 
6613 



OATABASE. 

LINE. 

LOG. 

LOG. 

LOG. 

LOG. 

FLOG. 

INBOX. 

INB0X1NX. 

WFLCODE. 

LFYLE. 

FYLE. 

FYLE. 

FYLE. 

CARO. 

PATCH. 

LINE . 

TEMPFILE. 

NEVWORKSOURCE. 

WORKSOURCE. 

NEWWORKSOURCE. 

MYOPTIONS. 

INBOXINX. 

A SUB FILE". 

F05AT 

REMOTE. . . 
"TEMPFILE* 0". 

TEMPF ILE '0" . 

TEMPFILE'O . 
"TEMPF ILE '0". 
F05B. 
F05B. 
F05A. 
USERMBOX. 
USERMBOX. 

TEMPF ILE ' 0" . 
"TEMPFILE'O". 
TFOLO. 
TFOLOX. 
NEWS. 
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TFOLO. 
WFLCODE. 
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TFOLOX. 
TFOLO. 
TFOLOX. 
F05A. 

NEWWORKSOURCE. 
SYMBOL. 
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MYOPTIONS. 
NEWTAPE. 
COOE. 



EXTNAME 

(ASTR0X)J0B6605. 
LINE. 

SUMLOG/8/100990/001419. 
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" MAIL/OUTGO ING/SFA1 7 A/NEW 
MAIL/0UTG01NG/SFA17A/NEW 
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Example 9 

In the following example, the DRCONLY option indicates that only DRC data is to be 
collected, the REPORT command signifies the beginning of the report specifications, 
and the SOURCE command selects the DRCDATA files as the source of information for 
the report. 

The SORT command selects the USERCODE, CHARGECODE, and ASCENDING 
options. The OUTPUT command selects the USERCODE, PACKNAME, DISKINUSE, 
MBYTEDAYS, USEDATE, USETIME, and CHARGECODE options as the data items 
to be printed. 

The BREAK command specifies that totals be accumulated and printed for 
DISKINUSE and MBYTEDAYS each time the value of the CHARGECODE and 
USERCODE control breaks change. The totals generated by the REPORTS command 
are printed immediately after a corresponding line of hyphens (-) is printed. 

The END command indicates the end of the report-specification commands. 

OPTION DRCONLY 
REPORT 

SOURCE IS DRCDATA 

SORT BY USERCODE, CHARGECODE, ASCENDING 

OUTPUT ITEMS ARE USERCODE, PACKNAME, DISKINUSE, MBYTEDAYS, USEDATE, 
USETIME, CHARGECODE 

BREAK ON USERCODE, CHARGECODE TOTALING DISKINUSE, MBYTEDAYS 

REPORTS ARE DETAILED SUMMARY 1 SUMMARY 2 

END 

Figure 8-9 shows the resulting report. 
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USERCODE 



PACKNAME 



DISKINUSE 



06/06/91 
MBYTEOAYS 



USEDATE 



USETIME CHARGECODE 



USERCODE: POQ 
CHARGECODE : 1130 

NEWMCPS 
NEWPACK 
SCRATCH249 
SCRATCH67 
DISK 

TESTMCPS 
SYS39 
OLDMCPS 
MCPS 
PACK 
MCPMAST 
- - - TOTALS FOR 1130 

TOTALS FOR POQ 

USERCODE : VIOLAN 
CHARGECOOE: 1278 

PACK 

TOTALS FOR 
- TOTALS FOR VIOLAN 



VIOLAN 
VIOLAN 



DISK 
1278 



USERCODE: MERVYN 

CHARGECOOE: 2046 

MERVYN MCPS 
MERVYN OISK 
MERVYN PACK 
MERVYN MCPMAST 
TOTALS FOR 2046 

- - - - TOTALS FOR MERVYN 

USERCODE: SMYTHE 

CHARGECODE: 1263 

SMYTHE NEWPACK 

SMYTHE OLDPACK 
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SMYTHE FIRE 

SMYTHE DISK 

SMYTHE OPS 
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0.00 
0.00 
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File Data Items 

Tables 8-1 through 8-3 describe all the file data items present in the JOBSUMMARY, 
STATISTICS, and FILEIODATA files. Table 8-4 describes the file data items present 
in the DRCDATA files. 



Table 8-1. JOBSUMMARY File Data Items 



Item 


Type 


Description 


t\\jVj LoooUUt 


string 


Accesscode (without password) of the entry 


MVutUK tUUUt 


integer 


Average core usage for job or task (code) 


AVGCOREDATA 


integer 


Average core usage for job or task (data) 


CARDSPUNCHED 


integer 


Number of cards punched 


CARDSREAD 


integer 


Number of cards read 


CHARGECODE 


string 


Chargecode for this entry (limited to 10 
characters) 


CHARGES 


charge 


Billing charges for this entry 


CODEFILE 


string 


Code file name for job or task 


DATE 


string 


Date of entry in form mm/dd/yy 


DESTMCS 


integer 


Destination MCS number for job or task 


DESTUNIT 


string 


Destination unit for job or task 


ELAPSEDTIME 


real 


Elapsed time in minutes 


INITPBITS 


integer 


Number of initial presence bit operations (job or 
task only) 


INITPBITTIME 


real 


Process time for initial presence bit operations 


IOTIME 


real 


I/O time in seconds 


JOBENTRYTIME 


string 


Time job entered system 


JOBNO 


string 


Job number of entry. The JOBNO data item is 
always four digits long, and is padded with 
leading zeros if necessary. 


JOBQUEUEDTIME 


real 


Time job in queue 


LINES 


integer 


Number of lines printed 


LOGOFFREASON 


string 


Reason for log-off (session only) 


LOGON REASON 


string 


Reason for log-on such as hello or split (session 
only) 



continued 
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Table 8-1. JOBSUMMARY File Data Items (cont.) 



Item 


Type 


Description 


LSN 


string 


Station number (session only). The LSN data 

Hem lb dlWdyb inicc Ulgllb lUIIg, dllU IS> pdUUcU 

with leading zeros if necessary. 


MLblNAMt 


string 


MCS number (session only) 


MEMINTCODE 


real 


Memory integral for job or task (code) 


h A IT h A 1 MTrv ATA 

ME Ml NT DATA 


real 


Memory integral for job or task (data) 


MIXNO 


string 


Mix number of entry. The MIXNO data item is 
always four digits long, and is padded with 
leading zeros if necessary. 


NAME 


string 


Job or task name. -MCS SESSION- for MCS 
session 


ORGMCS 


integer 


Originating MCS number for job or task 


ORGUNIT 


string 


Originating unit number for job or task 


ati i r*n noiTf 

OTHER PBITS 


integer 


Number of other presence-bit operations (job or 
task only) 


OTHERPBITTIME 


real 


Process time for other presence bit operations 


PRIORITY 


integer 


Priority 


PROCESSTIME 


real 


Processor time in seconds 


QUEUE 


string 


Queue number. The QUEUE data item is always 
three digits long, and is padded with leading 
zeros if necessary. 


STANAME 


string 


Station name (session only) 


STARTTIME 


string 


Time of program initiation in the form hh:mm:ss 


STOPTIME 


string 


Time of program termination in the form 
hh:mm:ss 


TERMCOND 


string 


Termination condition for job or task 


TYPE 


string 


J for job, T for task, and S for MCS session 


USERCODE 


string 


Usercode 
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Notes: 

• String items cannot be totaled or averaged; however, all other 
items can. 

• LOGGER computes the ELAPSEDTIME value for RESTART 
MCS sessions from the LOGON and LOGOFF log records 
instead of using the ELAPSEDTIME value in the LOGOFF 
record. 

• The CHARGECODE as reported by LOGGER is limited to 10 
characters. The first 10 characters are used. CHARGECODEs 
longer than 10 characters are truncated in the printed report. 

• LOGGER computes the USERCODE value from the Major Type 
1, Minor Type 2 (EOJ) or 4 (EOT) log entry for the process. 



Table 8-2. STATISTICS File Data Items 



Item 


Type 


Description 


DATE 


string 


Date of log entry in the form mm/dd/yy 


DISK 


integer 


Number or disk file opens during interval 


HL 


integer 


Number of halt/loads 


JOBS 


integer 


Number of jobs initiated 


MAXJOBS 


integer 


Maximum number of jobs running at one time 


MAXTASKS 


integer 


Maximum number of tasks running at one time 


MISCFILES 


integer 


Number of file opens not included in the other file open 
counts 


PACK 


integer 


Number of pack file opens 


PUNCH 


integer 


Number of punch file opens 


READER 


integer 


Number of card reader file opens 


REMOTE 


integer 


Number of remote file opens 


SESSIONS 


integer 


Number of MCS sessions initiated 


TAPE 


integer 


Number of tape file opens 


TASKS 


integer 


Number of tasks initiated 


TIME 


string 


Time of day in the form hh:mm:ss at the beginning of 
the 15-minute interval 
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Notes: 

• String items cannot be totaled or averaged; however, all other 
items can. 

• The MAXJOBS and MAXTASKS items counts are obtained 
by counting beginning of tasks (BOTs) and beginning of jobs 
(BOJs) and subtracting end of tasks (EOTs) and end of jobs 
(EOJs). Therefore, missing log entries cause errors in these 
data. 



Table 8-3. FILEIODATA File Data Items 



Item 


Type 


Description 


; ACCESSCODE 


string 


Accesscode (without password) for this entry 


AREASIZE 


integer 


Area size 


ASSOCIATION 


string 


ASSOCIATION of file close 


r-l 1 AOI/A |"fr 

BLOCKSIZE 


integer 


Block size in words (value is rounded up if units 
equal characters) 


BUFFERSIZE 


integer 


BUFFERSIZE file attribute 


BUFFSOURCE 


string 


Buffer size source. The possible values are 

• BLOCKSIZE, indicating that the buffer size 
of the file was based on the BLOCKSIZE file 
attribute because the BUFFERSIZE file 
attribute is not applicable to this file. 

• BUFFERSIZE, indicating that the buffer size 
of the file was specified through an 
assignment to the BUFFERSIZE file 
attribute. 

• BUFFERGOAL, indicating that the buffer 
size of the file was based on the 
BUFFERGOAL memory management 
parameter of the SF (Set Factors) system 
command. 


CCSVERSION 


string 


CCSVERSION file attribute (disk and CD files) 


CHARGECODE 


string 


Chargecode for this entry (limited to 10 
characters) 


CHARGES 


charge 


Billing charges for this entry 


CLOSETYPE 


string 


Type of close 


CREATIONDATE 


string 


Creation date in yyddd 


DENSITY 


string 


DENSITY file attribute 



continued 
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Table 8-3. FILEIODATA File Data Items (cont.) 



Item 


Type 


Description 


DISPOSITION 


string 


DISPOSITION of file close 


DUMMYFILE 


string 


DUMMYFILE if attribute is true, otherwise blank 


EXTMODE 


string 


EXTMODE file attribute 


EXTNAME 


string 


External name of the file 


FAMILYNAME 


string 


FAMILYNAME file attribute (disk files) 


FILEKIND 


string 


FILEKIND file attribute 


FILESTRUCTURE 


string 


FILESTRUCTURE file attribute (disk files) 


FRAMESIZE 


intpppr 


FRAMESIZE file attribute 

i 1 \ 1 \ IVi 111*-' CJ LLI 1 UU \.\~f 


INTMODE 


string 


INTMODE file attribute 


IOTIME 


real 


I/O time used in seconds 


INTNAME 


string 


Internal name of the file 


JUbINO 


string 


Job number. The JOBNO data item is always 
four digits long, and is padded with leading zeros 
if necessary. 


KIND 


string 


KIND file attribute 


MAXREGSIZE 


integer 


Maximum record size in words (value is rounded 
up if units equal characters). 


MIXNO 


string 


Mix number. The MIXNO data item is always 
four digits long, and is padded with leading zeros 

if nppp^flrv 


REELNO 


string 


Reel number for tape files. The REELNO data 
item is always six digits long, and is padded with 
leading zeros if necessary. 


RETENTION 


string 


SCRATCH, PERMANENT, or none 


SAVEFACTOR 


string 


SAVEFACTOR 


SERIALNO 


string 


Serial number 


TIMC 

1 IIVIL. 


String 


Time of file close as hh:mm:ss 


UNITNO 


string 


Unit number. The UNITNO data item is always 
five digits long, and is padded with leading zeros 
if necessary. 



continued 



8-40 



8600 0478-100 



LOGGER 





Table 8-3. 


FILEIODATA File Data Items (cont.) 


Item 


Type 


Description 


UNITS 


string 


Units 


USE 


string 


Note: The UNITS item is scheduled for 
deimplementation in a future 
release. The FRAMESIZE and 
INTMODE items can be used 
instead to provide the same 
information. 

IN, OUT, or I/O 


USERCODE 


string 


Usercode 



Notes: 



• String items cannot be totaled or averaged; however, all other 
items can. 

• For information about the file attributes corresponding to 
FILEIODATA items, refer to the A Series File Attributes 
Programming Reference Manual. 



Table 8-4. DRCDATA File Data Items 



Item 


Type 


Description 


ACCESSCODE 


string 


The first of the values defined for the 
ACCESSCODELIST usercode attribute in the 
USERDATAFILE 


CHARGECODE 


string 


Chargecode for this entry 


CHARGES 


charge 


Billing charges for this entry 


DISKINUSE 


real 


Disk space currently in use by the specified user 
on the specified pack. This value is reported in 
megabytes. 
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Table 8-4. DRCDATA File Data Items (cont.) 



Etem 


Type 


Description 


MBYTEDAYS 


real 


The disk integral value for the specified user on 
the specified pack. This value is reported in 
megabyte-days, which is the number of 
megabytes used multiplied by the number of 
days the pack is used. For example, if a user 
stores one megabyte on a pack for one day, the 
MBYTEDAYS value is one. The value is 
recalculated by the DRC system every time the 
amount of space in use by the specified user is 
changed. 


PACKNAME 


string 


The family name of the disk for this entry 


USEDATE 


real 


The date that the system last updated the DRC 
disk usage for this entry 


USERCODE 


string 


The usercode for this DRC entry 


USETIME 


real 


The time that the system last updated the DRC 
disk usage for this entry 



Long-Term Report Generation 

LOGGER is able to generate long-term reports. These reports can cover more than 
one day or more than one log file. The following types of long-term reports can be 
generated: 

9 Reports based on data files or log files accumulated over a certain period. 
• Reports based on year-to-date totals . 

Extended Time Period Reports 

By default, LOGGER bases its report on data found in the current log file 
(SYSTEM/SUMLOG). Refer to Section 12, "SUMLOG," for information about 
SYSTEM/SUMLOG. The SUMLOG is found on the current log family, as specified 
by use of the DL (Disk Location) system command. Refer to the A Series System 
Commands Operations Reference Manual for information about the DL command. 
However, the USE command can be supplied to the program to specify that its source 
information is elsewhere. Refer to "USE Command" for more information. 

Only one USE command can appear in an input deck. If none appears, the current 
SYSTEM/SUMLOG is used. The USE SYSTEM/SUMLOG command explicitly specifies 
that the current SYSTEM/SUMLOG is to be used. 
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The following commands indicate that system logs released through a TL (Transfer 
Log) system command are to be used. Refer to the A Series System Commands 
Operations Reference Manual for information about the TL command. 

Command Description 

USE SUMLOG CURRENT SUMLOG files with the current date in their titles are 

to be used. 

USE SUMLOG <mmddyy> SUMLOG files with the given date in their titles are to 

be used. 

USE SUMLOG <mmddyy SUMLOG files whose titles contain date between the 

mmddyy> two given dates, inclusive, are used. 

The following commands indicate that existing J OBSUMMARY, STATISTICS, and 
FILEIODATA files are to be used to generate reports: 

Command Description 

USE CURRENT Files with the current date in their titles are used. 

USE <mmddyy> Files with the given date in their titles are used. 

USE <mmddyy mmddyy> Files whose titles contain dates between the two given 

dates, inclusive, are used. 



Year-to-Date Totals Reports 

LOGGER can create, update, and generate reports from a year-to-date totals file. 
These options are invoked by specifications in the OPTION command. Refer to 
"OPTION Command" for more information. 

The year-to-date totals file has a structure that is implicitly defined by the report 
specifications used to create it. Each record corresponds to a change in a control break 
item and contains those totals or averages that were generated at that point. 

For example, if the year-to-date file was created by a report that specified USERCODE 
and CHARGECODE as control break items and totaled processor time, I/O time, 
elapsed time, and charges, each record in the year-to-date totals file would correspond 
to one combination of usercode and chargecode and would contain the previously 
mentioned totals. 

Because the structure of the report determines the structure of the file, any report can 
be used to create the file initially. However, after this initial file creation, all updates 
must be performed by either the same report or a report with the same control break 
items and totals. If the program detects that the report being used to update the 
year-to-date file has a different structure than that file, it does not perform the update 
and issues an error message. 

The internal name of the year-to-date file is YTDFILE. The YTDFILE file can be 
file-equated. When LOGGER is run with the UPDATE option enabled, it first checks to 
see if the file already exists. Refer to "OPTION Command" for information about the 
UPDATE option. If the file exists, it is updated; otherwise, a new file is created. 
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Only the totals for the last specified control break item are kept in the file. For 
example, if the report used to create the file had the following BREAK commands, 
then only totals for ELAPSEDTIME would be kept in the year-to-date totals because 
ELAPSEDTIME is the only item specified at the innermost level: 

BREAK ON USERCODE TOTALING PROCESSTIME, IOTIME 
BREAK ON CHARGECODE TOTALING ELAPSEDTIME 



Year-to-Date File Updates 

When the year-to-date file is updated, no existing records are modified, and new records 
are added at the end of the file. At the time that the year-to-date report is generated, 
the program locates all records concerning the same combination of control break 
items and totals all of the appropriate totaled items at that time. Each record in the file 
contains the date on which that record was added to the file, which makes it possible to 
determine what changes were made on each update to the year-to-date totals. The date 
stored in the YTDFILE record is in Julian form (yyddd) to enable the year-to-date file 
to run longer than one calendar year. 



Year-to-Date Totals File Format 

Figures 8-10 through 8-12 illustrate the file format of record numbers 1 through 3. 

Record number 1 contains 60 words of control break item descriptions, as shown in 
Figure 8-10. 



WORD 0 


WORD 1 


WORDS 


NB 


47:16 
IDX 


31:16 


15:16 






Word 

0 

1 through 58 



59 



Figure 8-10. Year-to-Date Record 1 Format 
Information 

NB (Number of control break items) 

IDX (IDTABLE index) 

LEN (Length of item in characters) 

STRT (Starting character position in the file) 

SF (Source file) 

0 (JOBSUM MARY file) 

1 (STATISTICS file) 

2 (Fl LEI ODATA file) 



Record number 2 contains the totaled item descriptions shown in Figure 8-11. 
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WORD 0 


WORD 1 


WORDS 


NB 


47:16 
IDX 


31:16 
LEN 


15:16 
STRT 


7:8 
TAF 





WORD 59 



SF 



Figure 8-11. Year-to-Date Record 2 Format 

Word Information 

0 NT (Number of totaled items) 

1 through 58 IDX (IDTABLE index) 

LEN (Not used) 

STRT (Start position or word index) 
TAF (0 if item is totaled, 1 if averaged) 



Record number 3 contains the item descriptions shown in Figure 8-12. 



BKD 


BI(2) 


BI(3) 


...BI(NB) 


TI(1) 


TI(2) 


TI(3) 


...TI(NT) 


C 


D 



Figure 8-12. Year-to-Date Record 3 Format 
Word Information 

n Bl (Control break items— character strings) 

Tl (Totaled control break item binary values) 

C (Count number of entries from which totals were 
obtained) 

D (Date) 

Program Operation Characteristics 

The following variations in the operating characteristics can affect LOGGER output. 

REPORT Commands and LOGREPORTS File 

A REPORT command indicates to LOGGER that it is to read a set of report 
specifications. Refer to "REPORT Command" for more information. 

If an integer is present in the REPORT command, the report is located in the 
LOGREPORTS file, and the integer is the identifying number of the report. 
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Report-specification commands are read until an END command is found, at which 
time reading of input records is resumed. If no integer is present in the REPORT 
command, the report-specification commands are assumed to be on input records 
immediately following the REPORT command. Commands are scanned up to column 
72. Columns 73 through the end can be used for sequence numbers or comments. 

A LOGREPORTS file can contain as many report specifications as are needed. Each 
command has an identifying number associated with it. 

In the following example, the LOGREPORTS file contains only two reports. The 
records containing a number sign (#) as the first character are the report identification 
records, and the number following the number sign is the identifying number of the 
report that follows it. 



Record Number Contents 

1 #1 

2 SOURCE FILE IS JOBSUMMARY 

3 OUTPUT ITEMS ARE NAME, USERCODE, 

STARTTIME 

4 PAGE SIZE IS 57 

5 HEADING IS "SYSTEM USAGE REPORT" 

6 END 

7 #2 

8 SOURCE FILE IS STATISTICS 

9 OUTPUT ITEMS ARE TIME, TASKS, JOBS, DISK, 

PACK, 

10 BREAK ON DATE 

11 SORT BY DATE, TIME 

12 END 



LOGGER does not provide facilities for updating the LOGREPORTS file; however, it 
can be updated using CANDE. The file can also be maintained as a card deck and put 
on disk by using the WFL DECK statement. Refer to the A Series Work Flow Language 
(WFL) Programming Reference Manual for information about the DECK statement. 

Calculation of Charges 

The JOBSUMMARY, FILEIODATA, and DRCDATA files include a CHARGES data 
item, which returns the dollar amount charged for various user activities on the 
system. LOGGER invokes a procedure in the BILLINGSUPPORT library to calculate 
the value of the CHARGES data item. LOGGER also passes the ACCESSCODE data 
item to BILLINGSUPPORT for use in its CHARGES calculations. BILLINGSUPPORT 
is a support library that is designed to be rewritten by the installation to meet its 
special billing needs. For further information about BILLINGSUPPORT, refer to the 
BILLINGSUPPORT symbolic and to the A Series System Administration Guide. 
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Corrections 

If the log contains erroneous data for an entry, the CORRECTION command allows the 
correct value to be given on the report. Refer to "CORRECTION Command" in this 
section for more information. 

If the results of the run are used to update the year-to-date totals file, the corrected 
value is used. If the report is being generated from log files instead of from an existing 
JOBSUMMARY file, the resulting JOBSUMMAEY file contains the corrected value. 
If the report is generated from an existing JOBSUMMARY file, the report shows the 
corrected value; however, the file is not changed. 

When correcting the CHARGES field, the value is an integer value in cents with no 
dollar sign ($). Refer to "Calculation of Charges" earlier in this section for information 
about the CHARGES field. 



Files and File Equation 



The following text describes how LOGGER files can be file-equated: 



CARD 
LINE 



LINE 



The input card reader file or line printer file, or both, can be 
file-equated as remote files to run from a CANDE terminal. The CARD 
file does not need to exist if input cards are not supplied. 

The following syntax should be used for installations with 
CATALOGING set to TRUE that require the LINE file to be file-equated 
to BACKUP TAPE: 



LOGREPORTS 

JOBSUMMARY 
STATISTICS 
DRCDATA 
FILEIODATA 



FI LE LINE(KIND=PRINTER, BACKUPKIND=TAPE, LABELTYPE-STANDARD) 

The LABELTYPE=STANDARD specification allows a volumed printer 
backup tape to be created. 

The file from which report specifications are read. No restrictions exist 
on file-equation. 

The titles of these files cannot be changed through file-equation 
because the program modifies the file titles in order to put the date in 
them. 



YTDFILE 



The year-to-date totals file. No restrictions on file-equation. 



$NODUMP Compile-Time Option 

SYMBOL/LOGGER contains an ONANYFAULT statement in the procedure that reads 
the log file to prevent the program from being terminated in the event of bad data in 
the log entry. If the program encounters a fault, it takes a program dump in case the 
fault was caused by a program error. The $NODUMP compile-time option, which can 
be used to recompile SYMBOL/LOGGER, suppresses program dumps. This option can 
be used when data in the log that causes the program to receive a fault is known to be 
present and program dumps are not wanted. 
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Program Information 

The following programming information is intended for those who wish to modify the 
program for use at a particular installation. However, this information is not necessary 
for understanding the use of the program. 

Overall Organization 

LOGGER performs the following steps: 

1. LOGGER reads input-specification and report-specification commands, 
checks syntax of input, and builds arrays for use by later steps. 

The main procedures involved are PROCESSINPUTCARDS and 
PROCESSREPORTSPECIFICATIONS. 

2. LOGGER reads the log file and creates the JOBSUMMARY, STATISTICS, 
DRCDATA and, optionally, any required FILEIODATA files. This step is 
omitted if data is obtained from an existing JOBSUMMARY, STATISTICS, 
DRCDATA, or FILEIODATA file. The main procedures involved are WRITEITEM, 
WRITEJOBSUMMARY, and WRITEIODATAFILE. 

3. LOGGER reads the JOBSUMMARY, STATISTICS, DRCDATA, or FILEIODATA 
file. LOGGER extracts appropriate items, and sorts by appropriate items as 
specified in the report specifications. LOGGER then prints a report. The main 
procedure involved is EDITOR. 

4. LOGGER writes a summary report if SUMMARY is specified in the REPORTS 
command. Refer to "REPORTS Command" for more information. The procedure 
involved is SUMMARYREPORT. 

5. LOGGER initializes a year-to-date totals file, if this file is requested. The 
procedure involved is INITI ALIZEYTDFILE . 

6. LOGGER generates a report from the year-to-date totals file. The procedure 
involved is YTDREPORT. This procedure is executed if the OPTION YEAR 
command is specified. Refer to "OPTION Command" in this section for more 
information. 



Structure of Program Files 

The program files contain the results of processing of the log entries and are passed to 
the EDITOR report-generation procedure. The JOBSUMMARY file has one record for 
each job, task, and MCS session found in the log. The STATISTICS file has one record 
for each 15 minutes of data in the log. The FILEIODATA file has one record for each 
file-close record found in the log. All data in these files, including numeric items, is in 
EBCDIC form. 

The following four value arrays are associated with each file: 

• IDTABLE 

• NAMEINFOTABLE 
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• SHORTNAMES table 

• NAMETABLE 

The first three value arrays are parallel tables (the nth entry in one corresponds to the 
nth entry in the others), and one entry exists in the table for each item in the files. 

The IDTABLE specifies where the item occurs in each record of the appropriate file, 
the length of the item, and its type of data. For example, taking the first item from the 
JOBIDTABLE (which is the IDTABLE for the JOBSUMMARY file), the listing shows a 
declaration of PLF (00 1,04,0). The first number is the starting character position in 
each record of the file where this item is found. Therefore, this item starts in character 
position 1. The second number is the length in characters; the item is four characters 
long. The third number is the data type. Zero specifies alphanumeric, one specifies a 
real number; two specifies an integer, and three specifies a field containing a floating 
dollar sign ($) in the CHARGES field. Refer to "Calculation of Charges" earlier in this 
section for additional information about the CHARGES field. All items are actually 
stored in EBCDIC characters, but the data-type field is used to decide what to do with 
the item when it must be totaled or averaged. 

The name of the totaled or averaged item must be found in an appropriate 
NAMEINFO TABLE (in this case, the JOBNAMEINFOTABLE). From the listing, 
JOBNAMEINF OTABLE has a value of PL(000,05), which means that the name of the 
item is found in the NAMETABLE starting at character 0 for five characters. 

The SHORTNAMES table, which contains the first six characters of each name, is 
used by the procedure scanning the report specifications. This procedure performs a 
MASKSEARCH of the the report specifications. SHORTNAMES table then goes to 
the parallel NAMEINFOTABLE, takes that information to locate the full name in the 
NAMETABLE, and takes the corresponding entry from the IDTABLE to determine the 
location of the data. 

Four array-reference variables are set to the appropriate arrays when the SOURCE 
command is processed. Refer to "SOURCE Command" for more information. When 
the EDITOR procedure is called to print the report, the procedure is passed one of the 
three files as a parameter. Because EDITOR uses the array-reference variables, it need 
not be aware of which file it is processing. The process is identical for each file. 



The procedure PROCESSREPORTSPECIFICATIONS builds several tables from the 
report-specification commands. These tables are then used by the EDITOR procedure, 
A brief description of each table is presented here, followed by Figures 8-13 through 
8-16 showing the fields in each table. 



Tables Used by the EDITOR Procedure 



BREAK INFO 



Contains information from the BREAK commands. 
Refer to "BREAK Command" for more information. 



EDITORINFO 



Contains an entry for each output item. 



INCLCHECK 



continued 
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continued 
EXCLCHECK 

TAITEMS 



Contains information from the INCLUDE and 
EXCLUDE commands. Refer to "INCLUDE Command" 
and "EXCLUDE Command" for more information. 

Contains information on the items specified for 
totaling and averaging. 



SUMMARYTOGF 


TAILEMSXF 


NOTAIF 


START F 


LEN6THF 



L 



LENGTH OF 
BREAK ITEM 



START COLUMN OF 
BREAK ITEM 



NUMBER OF TOTALED AND AVERAGED 
ITEMS FOR THIS BREAK ITEM 



STARTING INDEX TO TAITEMS TABLE, 

WHICH KEEPS INFORMATION ON 
TOTALED AND AVERAGED ITEMS 



1 NON-ZERO IF SUMMARY REPORT REQUESTED 



Figure 8-13. BREAKINFO Table 



Note: Items STARTF and LENGTHF are duplicates of information kept in 
IDTABLE and are used to identify the item. Refer to "Structure of 
Program Files" earlier in this section for additional information 
about IDTABLE. 





OUTF 


STARTF 


LENGTHF 



DUPLICATE OF 
IDTABLE 



START COLUMN IN PRINT BUFFER 
WHERE ITEM IS TO GO 



Figure 8-14. EDITORINFO Table 
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ITEMIDF 


COMPTYPEF 


ITEMTYPEF 




INDXF 



[ WORD VALUES 
FOR IEVALUES 
(FOR NUMERIC 
COMPARISONS) 
OR 

CHARACTER INDEX 
TO IESTRINGS 
(FOR STRING 
COMPARISONS) 

0 = NUMERIC CONPARE 

1 = STRING COMPARE 



1 COMPARISON TYPE 0 - = 

1 - NEQ 

2 - LEQ 

3 - GEQ 

4 - > 

5 - < 



1 INDEX TO IDTABLE 



Figure 8-15. INCLCHECK and EXCLCHECK Tables 





AVGF 


TOTALF 


IDINDXF 


COUNTF 



! _ RUNNING COUNT OF 
NUMBER OF ENTRIES 
PROCESSED 



INDEX TO IDTABLE 
FOR THIS ITEM 



I = 1 IF ITEM IS BEING TOTALED 



1 — = 1 IS ITEM IS BEING AVERAGED 



Figure 8-16. TAITEMS Table 



Note: A parallel table, TA, is used to hold the current total value for the 
corresponding TAITEMS entry. 



Files Used by the Program 



The following types of files are utilized by LOGGER. 
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Table 8-5. Files Used by LOGGER 



File Type 


Name 


Description 


Global 


LOG 


The input log file. By default, the title 
is SYSTEM/SUM LOG; however, it can 
be changed to another file if a USE 
command is specified. Refer to "USE 
Command" for more information. 




DRCAUDIT 


This file is created when the 
RESETDRC option is specified. 
DRCAUDIT contains all the records 
generated by LOGGER. The records are 
in the format used by the 
BILLINGSUPPORT library. The records 
contain the values accumulated before 
the MBYTEDAYS field was set to 
zero (0). If any billing information is 
lost, a program can read the 
DRCAUDIT file and then call the 
BILLINGSUPPORT library to calculate 
the charges. 




JOBSUMMARY 
STATISTICS 
DRCDATA 
FILEIODATA 


Refer to "LOGGER Operation" earlier in 
this section for information about the 
JOBSUMMARY, STATISTICS, 
DRCDATA, and FILEIODATA files. 




OUTFILE 


Used by the procedure EDITOR when a 
SORT command is included in the 
report specifications. Refer to "SORT 
Command" for more information. 
EDITOR performs a sort whose output 

Ol ITFII F Thi<i niitnut i<; thpn rparl in 
to uu I I I i_i — . I iiio uui|JUi lo nidi icau in 

to print the report. 




IMMAPV 
oUIVMVIMrvl 


If o DCDADTQ ^nmrYiQnH cr^^r^ifiac o 
II a RtrUK lo CulllllldllU bpcGlllcb d 

summary report, the procedure 
BREAKCHECK saves information in 
this file each time a break occurs. 
Refer to "REPORTS Command" for 
more information. The file is read in 
later by the procedure 
SUMMARYREPORT. 




YTDFILE 


The year-to-date totals file 




PRNT 


The printer file. Its INTNAME is LINE. 


Local To PROCESSIN- 
PUTCARDS 


CARD 


The card reader file 



continued 
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Table 8-5. Files Used by LOGGER (cont.) 



File Type 


Name 


Description 




LOG REPORTS 


The file from which the report 
specifications are read 


Local To 

INITIALIZEYTDFILE 


NEWYTDFILE 


When updating an existing YTDFILE 
file, all records prior to the current day 
are copied into NEWYTDFILE, and the 
old YTDFILE is then removed. Refer to 
to YTDFILE in this table for more 
information. The title of NEWYTDFILE 
is changed to that of the old YTDFILE 
so that the updated file has the same 
name. 
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Peripheral Test Driver (PTD) 



The peripheral test driver (PTD) is an interpreter program that is part of the master 
control program (MCP). It interprets s-ops that are found in test-case semicompiled 
code (s-code) files that were created to test peripheral equipment on a system. PTD is 
available on all A Series systems. 

A test case is written with either a physical device or a BADDISK file as its target. The 
connection between the test case and test object is established by way of 

• A programmatic test case data structure called a DEVICESTRUCTURE 

• The OPEN s-op 

• A device mnemonic or disk file name entered by the user 

The test case s-code files and descriptions of the peripheral tests that can be performed 
are found on the PTDTESTS TAPE. 

Test cases are organized into numbered "sections" that perform certain operations. 
Those sections that fall into logical categories are called blocks. For example, block 
100 can consist of sections 101, 102, and 103, where those particular sections test the 
TESTID, the READBUFFER, and the WRITEBUFFER operations respectively. Other 
blocks can consist of sections designed to perform complex sequences of data transfer 
that drive a peripheral or data link processor (DLP) at a certain level of tolerance. 
Sections numbered from 3000 above are special sections that are not performed unless 
they are explicitly invoked by the user. 

Refer to the RUN and REPEAT directives in this manual for information on explicitly 
invoking certain sections. Section 4000 lists what the other sections do and is 
particularly useful. Refer to the PTDTESTS TAPE for each test case's organization. 

The following steps are necessary to execute a peripheral test: 

1. Execute PTD. 

2. Select the directives necessary for the test. 

3. Select the directives unique to IOP PTD. 

4. Reserve the peripheral to be tested, if necessary. 

Descriptions of these procedures follow. 
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PTD Statement 

The PTD statement is recognized by the Work Flow Language (WFL) compiler, and 
starts SYSTEM/MAINTENANCE as an independent runner. 

To initiate a test on a particular type of peripheral, DLP, Control (CTL), or data 
communications data link processor (DCDLP) the statement must also contain 
file-equate syntax. That syntax should file-equate the PTD internal s-code file to the 
appropriate test case code file. 

The A Series systems allow PTD to operate from either an operator display terminal 
(ODT) or a data comm terminal. In either case, all PTD input and displays are done 
through a logical file titled PTDSPO. When using the ODT, all input to PTD must have 
a triangular GS (group-separator) in column 1. This character directs the entry to PTD 
instead of to the CONTROLLER. To direct the operator dialog to a data comm station, 
the user should change the KIND of PTDSPO to REMOTE and the TITLE of PTDSPO 
to the station name; GS is not used with this medium. 



For users primarily debugging test case code or PTD itself PTD can be executed with a 
VALUE clause that sets certain of its options immediately at run time. The relevant 
bits are 

Bit Option Set Function 

[2:1] TRACE Test-case s-ops in execution 

[1:1] DUMP Test-case virtual memory dump 

[0:1] PGMDUMP Program dump of PTD 



Hence, executing PTD with VALUE = 2 causes the DUMP option to be set, VALUE = 3 
sets both DUMP and PGMDUMP, and so on. 



General Execution Syntax 

In general, PTD is executed by entering a statement in the following form, where 
< s-code file name> is the name of the test case code file found on the PTDTESTS 
TAPE: 

PTD; FILE SCODE (TITLE = <s-code file name>) 

Other items are entered depending on the user's choice of dialog device and the user's 
rare decision to add the VALUE clause. Actual s-code file names are used in the 
following examples. Refer to the PTDTESTS Tape for a description of the release tape, 
file naming conventions, and individual test case documentation. 
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ODT Execution Examples 

In the following examples, PTD is executed at an ODT, and all subsequent operator 
dialog occurs at that ODT: 

• To execute PTD in conjunction with the test case s-code file named PTD/MAINT/CP, 
enter the following command: 

PTD; FILE SCODE(TITLE = PTD/MAINT/CP) 

• To execute PTD in conjunction with the test case s-code file named PTD/CONF/CR 
found on the family disk named DMS and to request a virtual memory dump prior 
to end-of-job (EOJ), enter the following command: 

PTD; FILE SCODE(TITLE = PTD/CONF/CR ON DMS); VALUE = 2 

• To execute PTD in conjunction with the PTD/MAINT/PE test case s-code file and 
to request a virtual memory dump prior to EOJ, enter the following command: 

BEGIN JOB; PTD; FILE SCODE(TITLE = PTD/MAINT/PE); VALUE = 2 

ODT Initiation, Remote (Data Comm) Dialog Device Examples 

In the following examples PTD is executed at an ODT but all further dialog occurs at 
the specified data comm terminal: 

• To execute PTD in conjunction with the test case s-code file named 
PTD/MAINT/HTS found on the family disk named DISK from a remote terminal 
with a station number of TD450365, enter 

PTD; FILE SCODE (TITLE = PTD/MAINT/HTS ON DISK); 
FILE PTDSPO(KIND = REMOTE, TITLE = TD450365) 

• To execute PTD in conjunction with the test case s-code file named PTD/CONF/PSS 
from a remote terminal station number 55, and to request a virtual memory dump 
as well as a PTD program dump prior to EOJ, enter 

PTD; FILE SCODE (TITLE = PTD/CONF/PSS); STATION = 55; VALUE = 3 
BEGIN JOB; PTD; FILE SCODE(TITLE = PTD/CONF/PE) ; STATION = 55 

Remote Execution Examples 

In the following examples PTD is executed at a logged-on Command and Edit (CANDE) 
terminal and all subsequent operator dialog occurs at that terminal. 
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i 

To execute PTD from a logged-on CANDE terminal in conjunction with the test case 
s-code file named PTD/MAINT/PE, enter one of the following commands: 

WFL BEGIN JOB; PTD; FILE SCODE (TITLE = PTD/MAINT/PE); 
VALUE = 1 

WFL BEGIN JOB; PTD; FILE SCODE (TITLE = PTD/MAINT/PE) 

WFL BEGIN JOB; PTD; FILE SCODE(TITLE = PTD/MAINT/PE ON TESTPACK); 

All subsequent operator dialog occurs at that terminal. 

PTD Directives 

When PTD is first executed, it performs some internal initialization steps that can take 
a few seconds to accomplish depending on the size of the test case code file and the 
number of other jobs in the mix. PTD displays the test case file name and release-level 
data, and then displays the following message: 

AWAITING DIRECTIVE 

PTD idles waiting for a directive to be entered. 

i 

Any valid PTD directive can now be entered, one directive per transmission. The RUN, 
REPEAT, and GO directives place PTD into immediate execution. When execution of 
the specified section or sections has been completed, PTD again displays the following 
message and idles until a new directive is entered: 

AWAITING DIRECTIVE 

Remember that if the ODT is used, GS must appear in column 1. 

The following are the possible directives. 
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DISPLAY 
DUM P 



uunr 

t- IOTRACE - 

- MONITOR - 
L- PGMDUMP - 
r- PRINT 

- TRACE 1 

ERROR -,- HALT — 

L_ IGNORE 

STATUS 

RUN 



L OFF 



I— <section 1ist > 

REPEAT -, >— , 

L-<section 1 i st> — ' I— FOR — <count> 



- GO - 
L- QUI T 



<section list> 

r<-/9\ 

— I— <section number>- 



— TO — ] — i— <section number> 
1 I— END 



The following text describes the meaning of each option: 
DISPLAY 



DUMP 



IOTRACE 



The DISPLAY directive displays messages on the ODT or remote 
terminal. The DISPLAY OFF form disallows such messages. 
When an ODT is being used, the DISPLAY OFF form causes PTD 
to close its PTDSPO file so that normal system display traffic can 
resume. By default, PTD displays messages on the ODT or 
remote terminal. 

The DUMP directive dumps the test case's stack and data 
memory to a printer file prior to EOJ. The DUMP OFF form stops 
such a dump. By default, PTD does not create this printer file 
unless a fatal execution error occurs. In that instance, the data is 
dumped unconditionally by PTD. That output should be 
submitted when reporting any test case or PTD problems. 

The IOTRACE directive displays input/output (I/O) information 
before and after every test case I/O operation. Prior to initiating 
the I/O, the MLI REQUEST and IOLENGTH are shown. After the 
I/O has completed, PTD displays the MLI RESULT, the number of 
data bytes transferred, and an IOP result. 

The user should be aware that whenever the words IOP RESULT 
are used in the context of PTD or a Unisys test case, they refer 
to a value constructed strictly for the purposes of a 
programmatic, host-independent result descriptor that 
summarizes errors that occur within the host to MLI interface. 
The true IOP result descriptor can be obtained only by inspecting 
the test case I/O control block or blocks (lOCBs) as they 
complete. The address of the IOCB is made available through 
the use of the special I/O options, described in "PTD Operator 
Interruption" in this section. 

The IOTRACE OFF form disallows the displaying of I/O 
information. By default, PTD does not display I/O information. 



continued 
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continued 
MONITOR 



PGMDUMP 



PRINT 



TRACE 



ERROR 



STATUS 



The MONITOR directive writes all display traffic to a printer file 
and places an asterisk (*) in column one of all operator entries. 

The MONITOR OFF form disallows the writing of all display 
traffic to a printer file. By default, PTD does not print display 
traffic. 

The PGMDUMP directive allows PTD to dump itself via 
PROGRAMDUMP to a printer file prior to EOJ. The PGMDUMP 
OFF form disallows such a dump. By default, PTD does not 
allow a dump. However, any fatal execution error that occurs 
causes an unconditional program dump. The output from that 
dump should be submitted when reporting any test case or PTD 
problems. 

The PRINT directive causes PTD to print test-case-specified text 
to a printer file when the PRNT s-op is encountered. The PRINT 
OFF form disallows such printing. By default, no text is sent to a 
printer file. 

The TRACE directive allows PTD to write each test case s-op to 
a printer file after the s-op is executed. It is used for test case 
and PTD debugging. Since vast numbers of s-ops are executed 
in the usual test case, tracing them is not economical. The 
TRACE OFF form disallows such writing. By default, PTD does 
not write each test case s-op to a printer file. 

The test case notifies PTD of any I/O error via the EROP s-op. 
PTD then stops and idles or ignores it, depending on the setting 
of the ERROR directive. 

If the ERROR HALT form is used, PTD halts on any nonfatal I/O 
error and displays "STOPPED ON ERROR." 

The user is expected to enter any valid PTD directive at this 
time. If the GO directive is entered, PTD continues execution at 
the next s-op. By default, the ERROR form is used. 

The ERROR IGNORE form causes PTD to treat all nonfatal test 
case I/O errors as no-ops and execution continues uninterrupted. 

Note: The test case can retry an HO as part of its 
testing algorithm, but no test HO is ever 
automatically retried by PTD or the operating 
system. 

The STATUS directive enables PTD to display its status. 
Information included is the number of the section currently in 
execution, the toggles currently set, and the current setting of the 
ERROR option. 

continued 
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RUN The RUN directive causes PTD to execute sections 100 to 

2999. 

The RUN <section lists> form allows the user to specify the 
sections or ranges of sections of a test case to be run. If a range 
of sections is specified, the second number must be greater than 
the first number. The END option can only appear as the last 
item in a <section list> and must be preceded by a starting 
section number. The use of END also causes PTD to go to EOJ 
when the execution of the final section has finished. 

The following are examples: 
RUN 

RUN 3999 

RUN 200 

RUN 101, 201 

RUN 203 TO 207, 301-302, 4000-END 

REPEAT The REPEAT directive executes sections 100 to 2999. 

The REPEAT <section list> form repeats the section or range of 
sections an infinite number of times. If the range of sections is 
specified, the second number of the range must be greater than 
the first number. The END option can only appear as the last 
item in a <section list> and must be preceded by a starting 
section number. The use of END does not cause PTD to go to 
EOJ when the execution of the final section has finished. 

The REPEAT <section list > FOR <count> form of the directive 
executes the specified section or range of sections a specified 
number of times. The maximum value of <count> is 
999999999. 

The following are examples: 

REPEAT 
REP F 3 

REPEAT 102 FOR 10 

REPEAT 101, 301, 102, 302 

REPEAT 207-209, 101, 305 - 400 

GO The GO directive allows PTD to resume execution at the same 

point it was stopped. It could have stopped because of an error 
condition or an operator interruption. Refer to "PTD Operator 
lnterruption"later in this section for more information. If PTD 
had finished executing a section list, the following message is 
displayed: "SECTION LIST COMPLETED. USE 'RUN' OR 
'REPEAT'". 

QUIT The QUIT directive terminates PTD. 



I OP PTD Directives 

The IOP PTD directives are used primarily as aids in developing and debugging PTD 
and test cases. They also are useful in observing the flow of test case I/O operations or 
in stepping an I/O through the processor using the IOSTOP directive. 
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Selecting any of these directives, with the exception of IOSTOP and LINES, causes 
PTD to analyze the test case I/O currently in process at a selectable point in the 
execution of the test. The appropriate DEVICESTRUCTURE information is displayed 
on the ODT or remote terminal. DEVICESTRUCTURE is the programmatic I/O 
interface between the test case and PTD and is analogous to a file information 
block (FIB). Up to ten separate DEVICESTRUCTUREs can be declared in the test 
case program in the Peripheral Test Language (PTL). Each DEVICESTRUCTURE 
carries all information relating to the I/O device, the I/O request, and the result of the 
operation. 

By default, these directives are disabled. When entering any of these directives an 
asterisk must precede them. 



HELP - 
BOJ — 
BO PEN - 
AO PEN - 
BI 1 0 - 
AII O - 
BCLOSE 
ACLOSE 
EOJ — 
IOSTOP 
ALL — 



IODEBUG 



- IODEBUG 

L LINES — <n>- 



The following text describes the meaning of each option: 



*HELP IODEBUG 



>BOJ 



*BOPEN 



*AOPEN 



r BIIO 



*AII0 



*BCLOSE 



* AC LOSE 



The *HELP IODEBUG directive displays an explanation of 
special I/O options. The *HELP IODEBUG OFF form disallows 
the display of these options. 

The *BOJ directive displays each DEVICESTRUCTURE the first 
time it is touched after this directive has been set. The *BOJ 
OFF form disallows this display. 

The *BOPEN directive displays each DEVICESTRUCTURE before 
it is opened. The *BOPEN OFF form disallows this display. 

The *AOPEN directive displays each DEVICESTRUCTURE after it 
is opened. The *AOPEN OFF form disallows this display. 

The *BIIO directive causes a display before the I/O is initiated 
out of each DEVICESTRUCTURE. The *BIIO OFF form disallows 
this display. 

The *AIIO directive causes a display after the I/O has completed 
on each DEVICESTRUCTURE. The *AIIO OFF form disallows 
this display. 

The *BCLOSE directive causes a display before each 
DEVICESTRUCTURE is closed. The *BCLOSE OFF form 
disallows this display. 

The *ACLOSE directive causes a display after each 
DEVICESTRUCTURE is closed. The *ACLOSE OFF form 
disallows this display. 



continued 
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continued 
*EOJ 

*IOSTOP 



*ALL 

*IODEBUG 



*LINES <n> 



The *EOJ directive causes a display of each 
DEVICESTRUCTURE immediately prior to EOJ. The *EOJ OFF 
form disallows this display. 

The *IOSTOP directive analyzes at each user-selected point. 
PTD programmatically stops after the DEVICESTRUCTURE 
display; entering any input or null reactivates PTD. If *BIIO has 
been set in addition to *IOSTOR then after the I/O information 
display and attendant stop/start, PTD executes a conditional halt 
prior to firing the I/O (CHLT must be set on the machine). 
4"10CB10CB10CB" is placed in the B-register and the address 
of the IOCB to be fired is placed in the A-register. 

The *IOSTOP OFF form disallows such an analysis. 

The *ALL directive selects all the directives described above. 
The *ALL OFF form turns all the directives off. 

The *IODEBUG directive analyzes TEST case I/O operations at 
selectable phases of execution. This directive is automatically 
selected if any of the above directives are selected. The 
*IODEBUG OFF form stops this analysis without disturbing the 
other directives selected. If the *IODEBUG form is subsequently 
selected, the analysis resumes. 

The *LINES <n> directive sets the number of lines of data 
displayed in the analysis output, thus allowing the user to view 
an entire data buffer. Forty HEX digits (10 MLI words) are 
displayed per line. The normal display is one line. The *UNES 
<n> OFF form returns the display to one line. 



Selecting Test Devices 

Once running, PTD eventually encounters an OPEN s-op and displays one of the 
following messages: 

ENTER DEVICE FOR peripheral designation> 

ENTER FILE NAME FOR <BADDISK designation> 

In these messages, the < peripheral designation > and the <BADDISK designation > 
are strings of characters that PTD finds in the DEVICESTRUCTURE and displays on 
the screen. For example, in the card reader test, the display looks like the following: 

ENTER DEVICE FOR CARDREADER 

In the case of a peripheral/DLP test on EMS systems, PTD expects the user to enter 
the following response. The underlines show the minimum abbreviations for the words 
in this command. 

<unit> VIA PATHID <pathid> 
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In the case of a peripheral/DLP test on Large Systems (LS) systems, PTD expects the 
user to enter the following response: 

<um't> VIA CTL <CTL id> 

Examples of possible responses are 
CR12 

PK57 VIA PATHID 17 
PK 100 VIA CTL 2001 

For BADDISK testing, PTD expects the user to enter the following response: 
<file title> ON <family name> 

An example of a possible response is 

BADDISK/ FMLYINX1/UNIT192/AD405000 ON PACK 



Reserving a Unit and Selecting a Path to That Unit 

With few exceptions, the unit being tested must be reserved using the UR (Unit 
Reserved) system command. The exceptions are as follows: 

• The pack scanner test does not require a reserved unit. 

• A unit cannot be reserved for the BADDISK confidence test. 

The selection of a path that the test case I/O operations are channeled through occurs 
in one of three ways: 

• Explicit specification by the user (using the VIA keyword) 

• Automatic selection by PTD 

• Dynamic selection by the operating system 

T3~ ^^^.u 4-~„4- „ n l £r„~ 4- ~ : i„ iL i „ „j_: i — r 3 

ijcvauoc caui icoi; taoc iiao umci cni 1 cijuiicmcuiB, pciuli nwctnuii iuics arc cuioiCBU 

by PTD on the basis of the type of test being executed. Examples of the different 
situations are described below. Some test cases issue operations that are dangerous 
in an online environment unless the path has been reserved through the UR system 
command. This command has the following form on EMS systems: 

UR <unit> PATHID <pathid> 

The UR command has the following form on LS systems: 

UR CTL <CTL id> 
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Other test cases, such as the BADDISK test, are not as dangerous and do not require a 
reserved path. Finally, explicit path selection in the online environment can interfere 
with the operating system's path selection algorithms for other users of the unit. This 
problem does not exist if the unit is reserved. 

Whenever a reserved path is selected by PTD or is specified by the user, PTD assigns 
itself to that path. This assignment is reflected in the response to any subsequent 
OL (Display Label and Paths) system command. On EMS systems, that display shows 
PATHSTATUS as either ASSIGNED RESERVED ONLINE or ASSIGNED RESERVED 
OFFLINE. As long as at least one test case DEVICESTRUCTURE is open to a unit 
through the reserved path, the path remains assigned to PTD, and no other invocation 
of PTD is able to use it until the path is unassigned. However, in any given invocation 
of PTD, one path can be used by more than one DEVICESTRUCTURE. Refer to "Path 
Selection Example 2" further on in this section. 

The following information describes the unique characteristics of some test cases. 

PACKSCANNER Tests (PTD/CONF/PS) 

Path selection by either the operator or PTD is allowed only if the unit has been 
reserved. The following messages are displayed by PTD when a reservation cannot be 
done or reserving a unit is not possible: 

• If the operator attempts path selection to an unreserved unit using commands such 
as PK 65 VIA PATHID 3 or PK 65 VIA, PTD responds with the following message: 

PATH SELECTION NOT ALLOWED UNLESS UNIT IS RESERVED. 

To correct this situation, the operator should reserve the unit and select a path 
again. 

• If the operator attempts path selection to a reserved unit, the specified path must 
be online and not assigned to any other stack. If the specified path is offline, PTD 
responds with 

PATH IS OFFLINE - TEST REQUIRES AN ONLINE PATH. 
If the specified path has been assigned to another stack, PTD responds with 

PATH IS IN USE. 

• If a path selection is not attempted and the unit is not reserved, the path is selected 
by the operating system. PTD, however, ensures that at least one path that is 
online and not reserved is available. If an available path cannot be found, PTD 
displays 

AT LEAST ONE PATH MUST BE ONLINE AND NOT RESERVED. 
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• If a path selection is not attempted and the unit is reserved, PTD automatically ' 
searches for an online path in the following order: 

1. The first search is for an online, unreserved path. On EMS systems, the path 
with the highest PATHID value is selected. For example, if PATHID values 11 
and 10 are available, then 11 is selected. 

2. The second search is for an online, reserved, unassigned path. On EMS 
systems, the path with the highest PATHID value is selected. 

3. If a suitable path is not found, PTD responds with 

NO PATHS TO THE UNIT ARE ONLINE. 

BADDISK Tests (PTD/CONF/BD20X and PTD/CONF/BD2X5) 

Since the test case requires a valid BADDISK file, the disk file header must be in 
memory so that the specified file can be located. Therefore, the unit cannot be reserved, 
and path selection is always left to the operating system. PTD ensures that at least one 
path is online and not reserved. 

• If the operator attempts to specify a path, PTD responds with 

PATH SELECTION NOT ALLOWED FOR THIS TEST. 

• If PTD cannot see available paths to the unit holding the file, the following message 
is issued: 

AT LEAST ONE PATH MUST BE ONLINE AND NOT RESERVED. 

All Other Confidence Tests (such as PTD/CONF/IVR and PTD/CONF/MT) 

A path does not necessarily have to be reserved. Path selection by the user is always 
allowed and an online, unassigned path is required. If path selection is attempted the 
unit must be reserved. 

Note: PTD/CONF/IVR is not available on the Micro A. Use the TVR 
program available from the Administrator menu. 

• If the user specifies an offline path, PTD responds with 

PATH IS OFFLINE - TEST REQUIRES AN ONLINE PATH. 

• If the user specifies an online, reserved path but the path is assigned to another 
stack, PTD responds with 

PATH IS IN USE. 
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• If a path selection is not attempted and the unit is reserved, PTD automatically 
searches for an online path in the following order: 

1. The first search is for an online, unreserved path. On EMS systems, the path 
with the highest PATHID value is selected. For example, if PATHID values 11 
and 10 are available, then 11 is selected. 

2. The second search is for an online, reserved, unassigned path. On EMS 
systems, the path with the highest PATHID value is selected. 

3. If no suitable path is found, PTD responds with 

NO PATHS TO THE UNIT ARE ONLINE. 

All Maintenance Tests (such as PTD/MAINT/=) 

Path selection by the user and PTD is allowed; however, the path must be reserved and 
not assigned to another stack. Remember that a unit must be reserved to make a path 
selection. 

• If an unreserved path is specified, PTD responds with 

PATH IS NOT RESERVED. 

• If a reserved path is chosen, but that path is assigned to another stack by another 
invocation of PTD, PTD responds with 

PATH IS IN USE. 

• If no path selection is attempted, PTD searches for a path in the following order: 

1 . The first search is for a path that is already assigned to this invocation of PTD. 
In this way, test cases with more than one DEVICESTRUCTURE value always 
use the same path unless the user specifies otherwise. On EMS systems, the 
highest numbered PATHID that meets this criteria is selected. 

2. The second search is for a reserved, online, unassigned path. On EMS systems, 
the path with the highest PATHID value is selected. 

3. The third search is for a reserved, offline, unassigned path. On EMS systems, 
the path with the highest PATHID value is selected. 

4. If no reserved path is found, PTD responds with 

NO PATHS TO THE UNIT ARE RESERVED. 
If all paths are reserved and assigned to other stacks, PTD responds with 

ALL PATHS TO THE UNIT ARE IN USE. 
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EMS Path Selection Example 1 



The following are valid responses for the device-request in the 206/207 disk pack 
maintenance test PTD/MAINT/HT20X. In this example there are four hypothetical 
paths to unit PK49. Those paths are as follows: 



PATHID Value 

11 
10 
09 
08 



Status 

RESERVED OFFLINE 
RESERVED ONLINE 
ON-LINE 

RESERVED ONLINE 



To the PTD request "ENTER DEVICE FOR DISK", the user can give any of the 
following responses: 



Response 

PK 49 

PK 49 VIA 



PK49 VIA PATHID 11 



Result 

PTD automatically selects PATHID 10 since it is the 
reserved, online path with the highest PATHID value. 

PTD displays all paths to the unit in a form similar to the 
response to an OL (Display Label and Paths) system 
command and then asks the user to select a reserved path 
from the list. 

Since this is a maintenance test and both the unit and path 
are reserved, this is an acceptable specification. 



EMS Path Selection Example 2 

Suppose that, in the maintenance test above, PATHID 10 was selected as the path for 
the first DEVICESTRUCTURE opened. The following information is displayed for any 
subsequent OL PK49 system command: 

PATHID Value Status 

11 RESERVED OFFLINE 

10 ASSIGNED RESERVED ONLINE 

09 ONLINE 

08 RESERVED ONLINE 

Now suppose that a second DEVICESTRUCTURE is opened. To the PTD request 
"ENTER DEVICE FOR DISK", the user can give any of the following responses: 

Response Result 

PK 49 PTD automatically selects PATHID 10, since it is the highest 

PATHID value that has already been assigned to an open 
DEVICESTRUCTURE. 

PK 49 VIA PTD displays all paths to the unit in a form similar to the 

response to an OL (Display Label and Paths) system 
command and then asks the user to select a reserved path 
from the list. 

continued 
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Response Result 

PK 49 VIA PATHID 1 1 Since this is a maintenance test and both the unit and path 

are reserved, this is an acceptable specification. 



LS Path Selection Example 



The following are valid responses for the device-request in the 206/207 disk pack 
maintenance test PTD/MAINT/HT20X. In this example, there are two hypothetical 
paths to unit PK 100. These paths are as follows: 

CTL Status 

2000 ONLINE 

2001 RESERVED 



To the PTD request "ENTER DEVICE FOR DISK", the user can give any of the 
following responses: 



Response 

PK 100 

PK 100 VIA 



PK 100 VIA CTL 2001 



Result 

PTD automatically selects CTL 2001 since it is the only 
reserved, online path. 

PTD displays all paths to the unit in a form similar to the 
response to an OL (Display Label and Paths) system 
command and then asks the user to select a reserved path 
from the list. 

Since this is a maintenance test and both the unit and path 
are reserved, this is an acceptable specification. 



PTD Operator Interruption 

PTD operates in a fetch s-op /execute s-op cycle and is sensitive to an operator interrupt 
request before each fetch operation. An interrupt request is serviced only when all 
outstanding test case I/O operations have been completed. When the operator-dialog 
device is an ODT, the operator can interrupt PTD by entering the following: 

<SYSTEM/MAINTENANCE mix number> HI 

An example is as follows: 

1127 HI 

When the operator dialog is through a REMOTE station, the HI statement must be 
preceded by a question mark in column 1. An example is as follows: 

?9142 HI 
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When interrupted, PTD responds with 



AWAITING DIRECTIVE 



Any valid PTD directive is accepted now. 



Test Case Example 



An example of the printed output of the PE tape DLP maintenance test showing the 
use of the RUN, REPEAT, and GO directives on EMS systems appears below. The 
example also illustrates one of the path-selection techniques. In this example, PTD was 
initiated at an ODT and was executed by the entry 

PTD; FILE SCODE(TITLE=PTD/MAINT/PE) 

After the AWAITING DIRECTIVE message appeared, the MONITOR directive was set 
so that subsequent operator entries are flagged with the asterisk in column 1. When 
the MT17 system command was first entered, PTD informed the operator that the unit 
was not reserved; the operator reserved it using the UR MT17 system command. To 
direct this command to the system, the operator omitted the GS character. Next, the 
MT 17 VIA system command was entered to PTD, resulting in the path information 
display and path selection query. When the device was successfully open, the test case 
later reported errors that were caused by the operator not having mounted a tape on 
the drive. With the exception of the operator dialog, all messages are produced by the 
test case. The dialog between operator and PTD follows. Operator responses are shown 
with asterisks(*). 

LISTING FOR TESTCASE=PTD/MAINT/PE 

AWAITING DIRECTIVE 
*PRINT 

AWAITING DIRECTIVE 
*RUN 101 

STARTING SECTION 0101 

— > ECHO OP - ALL BITS OFF 

ENTER DEVICE FOR MAGTAPE 
*MT 17 

UNIT MT 17 : NOT RESERVED. 
ENTER DEVICE FOR MAGTAPE 

[COMMENT: operator reserved MT 17] 
*MT 17 VIA 

UNIT 'MT17': 
DLP ID =04 
BASE NUMBER = 000 
RELATIVE UNIT (W.R.T. DLP) = 1 



PATH INFORMATION 



PATH ID PROC 
02 3 



IOPPORT LEMPORT DLPNUM PATHSTATUS 

1 0 6 RESERVED, ONLINE 



9-16 



8600 0478-100 



Peripheral Test Driver (PTD) 



ENTER DESIRED PATH ID 
*02 

AWAITING DIRECTIVE 
*REPEAT 102 FOR 3 

STARTING SECTION 0102 

--> ECHO OP - ALL BITS ON 

STARTING SECTION 0102 

— > ECHO OP - ALL BITS ON 

STARTING SECTION 0102 

— > ECHO OP - ALL BITS ON 

AWAITING DIRECTIVE 
*RUN 200-END 

STARTING SECTION 0200 

— > OP CODES TEST 

### TEST SEL = 0200 TEST RUN = 0201 ################ 

OPCODE+VAR = 2F1000 

OPCODE = 2F0000 = TEST 

+ UNIT NUMBER = 1(01) 

& IDLENGTH = 0006 CHARACTERS 

CYCLE=001 1/0=00013 ERR:IOP=000 L=000 RD=001 DATA=000 
RESULT DESCRIPTOR IS 41100000 
RD WD1 4000 = DESCRIPTOR ERROR 
RD WD1 0100 = TAPE UNIT NOT READY 
RD WD1 0010 = WRITE LOCKOUT 
RESULT DESCRIPTOR EX 00800000 
RD WD1 0080 = BOT (BEGINNING OF TAPE) 
### RD ERROR ##################### RD ERROR ######### 
STOPPED ON ERROR 
*G0 

### TEST SEL = 0200 TEST RUN = 0201 ################ 

OPCODE+VAR = 2F1000 

OPCODE = 2F0000 = TEST 

+ UNIT NUMBER = 1(01) 

& IDLENGTH = 0006 CHARACTERS 

CYCLE=002 1/0=00014 ERR:IOP=000 L=000 RD=002 DATA=000 
RESULT DESCRIPTOR IS 41100000 
RD WD1 4000 = DESCRIPTOR ERROR 
RD WD1 0100 = TAPE UNIT NOT READY 
RD WD1 0010 = WRITE LOCKOUT 
RESULT DESCRIPTOR EX 00800000 
RD WD1 0080 = BOT (BEGINNING OF TAPE) 
### RD ERROR ##################### RD ERROR ######### 
STOPPED ON ERROR 
*QUIT 
*** EOJ PTD *** 
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Section 10 

REPORTLOGENTRI ES 



REPORT_LOG_ENTRIES is an exported MCP procedure that forwards copies of 
selected types of system log entries to user programs whenever the system generates 
those log entries. REP ORT_LOG_ENTRIES allows the user program to specify 
the types of log entries that should be forwarded. If a selected log entry has been 
suppressed from the system log file, REP ORTLOGENTRIES still forwards it to 
the user program. The following are some of the types of applications that can be 
implemented through the use of the REPORTLOGENTRIES procedure: 

• Real-time billing applications. By monitoring Major Type 1, Minor Type 2 (EOJ) or 
Minor Type 4 (EOT) log entries, the application can track the total system resource 
usage accumulated by each usercode or charge code. 

• Security auditing applications. By monitoring log entries such as Major Type 6, 
Minor Type 4 (Security Violation), the application can detect attempts to breach 
system security as they occur. 

• User notification applications. For example, by monitoring Major Type 1, Minor 
Type 12 (Print Request Complete) log entries, an application can determine that a 
user's print request has completed and can send a notification to that user. 

A related system-monitoring procedure exported by the MCP is the 
STATUS_CHANGE_REQUEST procedure, which is discussed in Section 11. 

User Program Requirements for 
REPORT_LOG_ENTRIES 

Because one of the parameters to REPORT_LOG_ENTRIES is a DCALGOL queue, 
user programs that call this procedure must be written in DCALGOL. 

The REPORT LOG ENTRIES procedure can be called only by system software and by 
privileged programs. You can use the MP (Mark Program) system command to mark 
programs as privileged programs. The MP command is discussed in the A Series 
System Commands Operations Reference Manual. 

Note: Being a privileged user is not equivalent to using a program that is 
marked with privileged status. Being a privileged user is insufficient 
to allow the use of this exported MCP procedure. 
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Declaring the REPORT LOG ENTRIES Procedure 

The user program must contain a declaration of the MCPSUPPORT library and a 
declaration of the REPORT_LOG_ENTRIES procedure. These declarations appear as 
follows: 

LIBRARY MCP(LIBACCESS=BYFUNCTION J FUNCTIONNAME="MCPSUPPORT") ; 

REAL PROCEDURE REPORT_LOG_ENTRIES (Q,VAL, INFO, EXTRA) ; 
VALUE VAL; 
REAL VAL; 
QUEUE Q; 

ARRAY INFO, EXTRA [0]; 
LIBRARY MCP; 



The following parameters to this procedure are explained under the following headings 
in this section: 

Parameter Heading 

Q "Allocating an Intercom Queue for REPORTLOGJENTRIES" 

"Waiting for Log Entries" 
"Interpreting the Log Entries" 

INFO "Selecting Log Entry Types" 

"Using the Security Mask Field" 

VAL "Selecting Log Entry Types" 

"Using the Security Mask Field" 

Procedure result "Detecting Error Conditions for REPORTLOGJENTRIES" 

The EXTRA parameter is reserved for future use, and is not further explained in this 
section. 



Selecting Log Entry Types 

The user program uses the INFO parameter to specify a list of log entry types; it uses 
the VAL parameter to specify whether monitoring is enabled or disabled for the log 

entry types listed in INFCX 

The INFO parameter identifies log entries by major and minor types. For definitions of 
all the major and minor types logged by the system, refer to Section 12, "SUMLOG." 
The format of this parameter is explained in Table 10-1. 
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Table 10-1. INFO Parameter Format 



Word 


Contents 


0 


The number of valid words in the array. If this word stores a value 
of 2, then all the minor types associated with the major type in 
word 1 are selected. 


1 


The major type of the log entries. 


2-n 


The minor types of the log entries. 



To enable monitoring of the log entries listed in the INFO parameter, the user program 
can assign a value of 1 to the VAL parameter. To discontinue monitoring of the log 
entries listed in the INFO parameter, the user program can assign a value of 0 to the 
VAL parameter. By repeatedly invoking the REP ORT LOG ENTEIES procedure with 
varying INFO and VAL values, the user program can selectively modify the list of log 
entry types that are monitored. 

For example, a user program could use the following statements to enable monitoring 
of major type 1, minor type 5 (File Open) and minor type 6 (File Close) log entries: 

A[0] := 4; 
A[l] := 1; 
A[2] := 5; 
A[3] := 6; 

REPORT_LOG_ENTRI ES (Q, 1 ,A,X) ; 

The same user program could then use the following statements to disable monitoring 
of major type 1, minor type 6 (File Close) log entries. Note that the second parameter, 
VAL, is assigned a 0 to indicate that the specified log entry type is to be disabled rather 
than enabled. 

A[0] := 3; 
A[l] := 1; 
A[2] := 6; 

REPORT_LOG_ENTRI ES (Q ,0 , A , X) ; 

The result of the previous example is that only major type 1, minor type 5 (File Open) 
entries continue to be monitored. The same user program can then use the following 
statements to enable monitoring of all major type 2 log entries: 

A[0] := 2; 
A[l] := 2; 

REPORT_LOG_ENTRI ES (Q , 1 , A , X) ; 

After these statements are executed, all major type 2 log entries and all major type 1, 
minor type 5 (File Open) log entries will be monitored. 
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Using the Security Mask Field 

On systems where InfoGuard security enhancement software is installed, the user 
program can use the security mask field of the VAL parameter to restrict the log 
entries returned based on their security relevance. The mask value causes the system 
to return a subset of the log entry types enabled by the INFO parameter. 

The security mask field is located at [07:04]. The following are the meanings of the bits 
in this field: 



Table 10-2. VAL Parameter Security Field 



Bit 


Contents 


7 


If set, reports log entries for actions that failed because they were 




security violations. 


6 


If set, reports log entries for actions that succeeded, but were 




security relevant. This category includes the following actions: 




• Some SETSTATUS entries 




• Use of the ??SECAD (Security Administrator Authorization) 




primitive system command 




• Assignments of attributes to tape volumes and directories 




• Operations on guard files 




• Changes to the USERDATAFILE 




• Initiation of a process with privileged or security administrator 




status 




• CANDE or MARC log-on of a user with privileged or security 




administrator status 


5 


If set, reports log entries for actions that failed and were not security 




relevant. 


4 


If set, reports log entries for actions that succeeded and were not 




security relevant. 



If the value of this field is zero (all bits are reset), then all the log entries permitted by 
the INFO parameter are reported. 

On non-InfoGuard systems, the system ignores the security mask field and returns all 
log entries allowed by the INFO parameter. 



Allocating an Intercom Queue for 
REPORTLOGENTRIES 

If the DCALGOL queue passed to the REPORT LOG ENTRIES procedure has 
not been initialized, the system automatically initializes the queue as a new 
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intercom queue. An intercom queue is a queue that provides communication among 
various system software processes. The system can dynamically create up to 47 
intercom queues for user programs that call REPORT_LOG_ENTRIES or the 
STATUSCHANGEREQUEST procedure, which is described in Section 11. 

Because the number of intercom queues is limited, you might wish to minimize the 
number of intercom queues the system must allocate for a user program. Fortunately, 
the system permits a user program to use a single intercom queue for more than one 
purpose. If a user program passes REPORT_LOG_ENTRIES an intercom queue that 
has already been initialized, the system uses the existing intercom queue rather than 
creating a new one. Thus, if you pass the same queue to the REPORT_LOG_ENTRIES 
procedure and the STATUS_CHANGE_REQUEST procedure, the system allocates 
only one intercom queue for their use. 

Additionally, message control systems (MCSs) can use the DCALGOL 
SETUPINTERCOM function to explicitly initialize an intercom queue before passing 
it to the REP ORT_LOG_ENTRIES procedure. The SETUPINTERCOM function is 
discussed in the A Series DCALGOL Programming Reference Manual. 

Detecting Error Conditions for REPORTLOGENTRIES 

The REPORT_LOG_ENTRIES procedure returns a real value as the procedure result. 
Nonzero values indicate that an error occurred. The following are the possible values: 

Result Meaning 

-1 The system could not allocate an intercom queue slot for the procedure. 

This error occurs if the system has already allocated 47 intercom queues to 
user programs calling the REPORT_LOG_ENTRIES and 
STATUS_CHANGE_REQUEST procedures. 

-2 through -4 These values each indicate internal errors in the operating system. 

-5 One or more of the minor types specified by the INFO parameter are 

invalid. 

-6 The size of the INFO array is incompatible with the request. The INFO 

array must be at least two words long, and the array must be large enough 
to hold the number of entries specified in word 0 of the array. 

Waiting for Log Entries 

The REP ORT_LOG_ENTRIES procedure exits once the system has inspected the VAL 
and INFO parameters and assigned the Q parameter to an intercom queue. Since the 
user program declares the actual parameters globally to the REPORT_LOG_ENTRIES 
procedure, the actual parameters continue to exist after the procedure exits. The user 
program can monitor the arrival of event messages by waiting on the QINSERTEVENT 
attribute of the queue. The QINSERTEVENT attribute is discussed in the A Series 
DCALGOL Programming Reference Manual. 

Note: Some log entries can be too large to be inserted in a DCALGOL 
queue. A program using REPORT LOG ENTRIES receives no 
notification of such log entries. The current size limit is 1536 words. 
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Interpreting the Log Entries 

The log entries returned in the Q parameter have the format explained in Table 10-3. 



Table 10-3. Q Parameter Log Entry Format 



Word 


Contents 


0 


If you are using the same intercom queue for more than one purpose, 
you can inspect the contents of this word to determine if the message 
was inserted by REPORT_LOG_ENTRIES or some other mechanism. 

Field Contents 

[47:08] Contains the value 2 1 . 
[39:08] Contains the value 1 5. 
[15:16] Contains the value 20. 


1 


Time of day in multiples of 2.4 microseconds. 


2-4 


These words are not used 


5-n 


The log entry. Log entries follow the formats documented in Section 
12, "SUMLOG," except that they begin in word 5 instead of word 0. 
To make the log entry match the formats shown in the SUMLOG 
section, copy words 5-n of the message to a second array, starting at 
word 0 of the second array. 



REPORT LOG ENTRIES User Program Example 

The following program uses the REP ORTLOGENTRIES procedure to monitor 
log-on activity on the system. An explanation follows the program. 

100 % ******************************************** 



105 % % 

110 % PROGRAM: FRIEND % 

115 % DESCRIPTION: NOTIFIES CALLER WHEN A SPECIFIED USER LOGS ON % 

120 % % 



X 2 5 % A" A" A" A~ A A" A" A" A* Ar "At A" A" A' A" A" A" A" A" A" A" A' A" A" A* A~ A" A" A" A" A' A" A" A" A" A" A" A" A" A" A" A" A" A" A" A' A" A" A" A* A' A' A' A' A' A' A" A' A* A' A" A" A' A" £g 

130 

135 BEGIN 
140 

145 LIBRARY MCP(LIBACCESS=BYFUNCTION, FUNCTIONNAME="MCPSUPPORT") ; 

150 REAL PROCEDURE REPORT_LOG_ENTRIES (Q, VAL, INFO, EXTRA); 

155 VALUE VAL; 

160 REAL VAL; 

165 QUEUE Q; 

170 ARRAY INFO, EXTRA [0]; 

175 LIBRARY MCP; 

180 

185 DEFINE 
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190 USERCODEINDEX = [19:20] #, 

195 NEW LOGON = 1 #, 

200 MSGHEADER = 5 #, 

205 SIGNONCLASS = MSGHEADER + 5 #, 

210 LINKTOUSERCODE = MSGHEADER + 7 #, 

215 LINESIZE = 80 #, 

220 MAXNAMESIZE = LINESIZE #, 

225 MAXMINORTYPES = 100 #, 

230 QENTRYSIZE = 100 #, 

235 SCREENSIZE = 1920 #; 

240 

245 INTEGER NAMESIZE, 



250 QINDEX; 

255 ARRAY NAME [0:MAXNAMESIZE-1] , 

260 QENTRY [0.-QENTRYSIZE-1] , 

265 TYPES [0:MAXMINORTYPES-1]; 



270 EBCDIC ARRAY EA [0: SCREENSIZE -1] ; 
275 BOOLEAN FOUND; 
280 QUEUE Q; 
285 POINTER QPTR, 



290 EAPTR; 

295 FILE STDIO (KIND = REMOTE, 

300 MYUSE = 10, 

305 MAXRECSIZE = SCREENSIZE, 

310 UNITS = CHARACTERS, 

315 BLOCKSTRUCTURE = EXTERNAL); 

320 



325 TYPES [0] := 3; 
330 TYPES [1] := 4; 
335 TYPES [2] := 1; 
340 

345 IF (REPORT_LOG_ENTRIES (Q, 1, TYPES, TYPES) < 0) THEN 
350 WRITE (STDIO, SCREENSIZE, 

355 "ERROR: INTERCOM QUEUE SLOT UNAVAILABLE") 

360 ELSE 
365 BEGIN 

370 WRITE (STDIO, SCREENSIZE, "ENTER FRIEND'S NAME:"); 

375 READ (STDIO, MAXNAMESIZE, NAME); 

380 NAMESIZE := STDIO. CURRENTRECORD; 

385 REPLACE EAPTR: EA BY "WILL NOTIFY WHEN ", 

390 POINTER(NAME) FOR NAMESIZE, 

395 " LOGS ON"; 

400 WRITE (STDIO, OFFSET (EAPTR) , EA) ; 

405 

410 FOUND := FALSE; 
415 WHILE NOT FOUND DO 



420 BEGIN 

425 WAIT (Q.QINSERTEVENT); 

430 REMOVE (QENTRY, Q) ; 

435 IF (QENTRY [SIGNONCLASS] = NEWLOGON) THEN 
440 BEGIN 

445 % FIND THE BEGINNING INDEX FOR THE USERCODE LINK 
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450 
455 
460 
465 
470 
475 
480 
485 
490 
495 



% MUST ADD "MSGHEADER" TO ADJUST FOR THE MESSAGE FORMAT 
QINDEX := QENTRY[LINKTOUSERCODE] .USERCODEINDEX + MSGHEADER; 



% POINT TO THE 8-BIT ID LENGTH (SEE STANDARD FORM FILE TITLE) 
QPTR := POINTER (QENTRY [QINDEX]) + 3; 



IF (REAL(QPTR,1) = NAMESIZE) THEN 



IF (QPTR + 1) = NAME FOR NAMESIZE THEN 
BEGIN 

REPLACE EAPTR:EA BY POINTER(NAME) FOR NAMESIZE, 



500 
505 
510 
515 
520 



END; 



WRITE (STDIO, OFFSET (EAPTR) , EA) ; 

FOUND := TRUE; 

END; 



HAS LOGGED ON !"; 



525 END WHILE; 
530 END; 
535 END. 

You must mark the object code file as privileged with the MP (Mark Program) system 
command. 

The statement at line 345 invokes REP ORTJLOGJENTRIES as a function and checks 
to see if the result value is less than zero; if so, the system was unable to allocate an 
intercom queue, and the program displays an error message. 

The following are the effects of the parameters passed at line 345: 

• The 1 passed to the VAL parameter specifies that this invocation requests one or 
more new log entry types to be monitored. 

• The TYPES array passed to the INFO parameter causes log entries of Major 
Type 4, Minor Type 1 (Log-On Entry) to be requested. This effect results because 
of the word 1 of TYPES was previously assigned a 4, and word 2 of TYPES was 
previously assigned a 1. 

• The TYPES array passed to the EXTRA parameter fulfills the requirement of 
passing a real array to EXTRA, even though this parameter currently has no 



400 request the user to enter a name, and then they display a confirmation message. 
The name is stored in the NAME array. 

Execution then enters the WHILE loop at lines 415 through 525. The statement at 
line 425 causes the program to wait for a message to appear in intercom queue Q. The 
statement at line 430 causes the program to remove the message from the queue and 
place it in array QENTRY. 

The statements at lines 435 through 520 make use of the Major Type 4, Minor Type 1 
(Log-On Entry) description in Section 12, "SUMLOG." Because the log entry starts at 
word 5 of QENTRY, the program adds 5 to the offset of the log entry words. Thus, the 



meaning. 
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statement at line 435 inspects word 10 of QENTRY for the sign-on class, because the 
sign-on class word of the log entry is normally word 5. 

The statement at line 455 assigns the offset of the usercode entry to QINDEX. To get 
this offset, the program looks in the usercode link word (word 7 in the log entry, thus 
word 12 in QENTRY). Table 12-1, "Link to Variable Items," shows that field [19:20] 
of a link word stores the offset. The program therefore extracts the value from field 
[19:20] and adds 5. 

The usercode is stored in standard form, as described in the discussion of the 
DISPLAYTOSTANDARD function in the A Series DCALGOL Programming Reference 
Manual. Standard form starts with three bytes that are useful for describing file titles, 
but not necessary for describing usercodes. The statement at line 470 assigns QPTR to 
a position just past this irrelevant data, pointing at the start of the length field. 

The statement at line 480 checks to see if the length of the usercode matches that of 
the usercode previously requested. If the length matches, the statement at line 485 
compares the contents of the two usercodes. If a match is found, the statements at 
lines 490 through 515 notify the user that his or her friend has logged on. 
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STATUS_CHANGE_REQUEST is an exported MCP procedure that allows user 
programs to monitor selected types of system events. The types of events that can be 
monitored include changes in process status and changes in system initialization 
status. STATUS_CHANGE_REQUEST accepts a parameter that you can use to specify 
the types of events to be monitored. The STATUS_CHANGE_REQUEST feature can 
be a useful element of supervisor programs and programs that display system status 
information to operators. 

Because STATUS_CHANGE_REQUEST is primarily a notification mechanism, 
it returns only basic information about the events it reports. For detailed 
information about most of these events, the program can use other interfaces 
such as REP ORTLOGENTRIES, GETSTATUS, and SYSTEMSTATUS. The 
REP ORTLOGENTRIES interface is described in Section 10. GETSTATUS is 
described in the A Series GETSTATUS/SETSTATUS Programming Reference Manual. 
SYSTEMSTATUS is described in the A Series SYSTEMSTATUS Programming 
Reference Manual. 
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User Program Requirements for 
STATUSCHANGEREQUEST 

Because one of the parameters to STATUS_CHANGE_REQUEST is a DCALGOL 
queue, user programs that call this procedure must be written in DCALGOL. 

The STATUS_CH ANGE_RE QUEST procedure can be called only by system software 
and by privileged programs. You can use the MP (Mark Program) system command to 
mark programs as privileged programs. The MP command is discussed in the A Series 
System Commands Operations Reference Manual. 

Note: Being a privileged user is not equivalent to using a program that is 
marked with privileged status. Being a privileged user is insufficient 
to allow the use of this exported MCP procedure. 
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Declaring the STATUSCHANGEREQUEST Procedure 

The user program must contain a declaration of the MCPSUPPORT library and a 
declaration of the STATUS_CHANGE_RE QUEST procedure. These declarations 
appear as follows: 

LIBRARY MCP(LIBACCESS=BYFUNCTION > FUNCTIONNAME="MCPSUPP0RT") ; 
REAL PROCEDURE STATUS_CHANGE_REQUEST(Q .SCEVENTS) ; 

ARRAY SCEVENTS[*]; 

QUEUE Q; 

LIBRARY MCP; 



The parameters to this procedure are explained under the following headings in this 
section: 

Parameter Heading 

SC EVENTS "Selecting Events for Notification" 

Q "Allocating an Intercom Queue for STATUS_CHANGE_REQUEST" 

"Interpreting the Event Messages" 

Procedure result "Detecting Queue Allocation Errors for 

STATUSCHANG E_R EQU EST" 
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Selecting Events for Notification 

To request notification of a particular type of event, the user program sets the 
corresponding bit in Word 0 of the SCEVENTS parameter. Table 11-1 shows the 
correspondence between bit positions and event types. 



Table 1 1-1 . Event Types 



Word 


Rit Position 


EvGnt 


0 


[22:01] 


A process terminated. This category includes all processes, 
whether or not they are WFL processes. 




[21:01] 


An operator has entered a system command, or the system 
has displayed a response to a system command. 




[19:01] 


A WFL job terminated. 




[18:01] 


A WFL job was initiated. 




[17:01] 


The MCP data comm tables have been deallocated, and all 
data comm has been terminated. 




[16:01] 


System initialization has reached the point where the data 
comm tables have been built. At this point, the MCP has 
read the DATACOM INFO file and has built station, line, and 
MCS tables. At this point, it is possible for an MCS to 
initialize its primary queue. 




[15:01] 


A WFL job was discontinued while it was in a job queue. 




[14:01] 


A WFL job entered a job queue. 




[13:01] 


A library process resumed execution. 




[12:01] 


A process was initiated. This category includes all 
processes, whether or not they are WFL processes. 




[11:01] 


A process froze and became a library process. 




[10:01] 


System initialization has reached the point where WFL jobs 
can be initiated. 



continued 
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Table 11-1. Event Types (cont.) 



Word 


Bit Position 


Event 




[09:01] 


There was a change to the number of user processes that 
have a particular database open. 




[07:01] 


A process has just created and closed a new tape file, 

pruUULIilg ld|Jc IdUcI llMUl HldllUII. 




[06:01] 


A unit changed status (for example, became online or offline 
or was purged). 




[05:01] 


A process issued an RSVP message. 




[04:01] 


A process changed priority. 




[03:01] 


A process other than a WFL process terminated. 




[02:01] 


A process other than a WFL process was initiated. 




[01:01] 


A process was scheduled. 



Allocating an Intercom Queue for 
STATUSCHANGEREQUEST 

If the DCALGOL queue passed to the Q parameter has not been initialized, the system 
automatically initializes the queue as a new intercom queue. An intercom queue is a 
queue that provides communication among various system software processes. The 
system can dynamically create up to 47 intercom queues for user programs that call 
STATUS_CHANGE_REQUEST or the REP ORT_LOG_ENTRIES procedure, which is 
described in Section 10. 

Because the number of intercom queues is limited, you might wish to minimize 
the number of intercom queues the system must allocate for a user program. 
Fortunately, the system permits a user program to use a single intercom queue for 
more than one purpose. If a user program passes STATUS_CHANGE_REQUEST 
an intercom queue that has already been initialized, the system uses the existing 
intercom queue rather than creating a new one. Thus, if you pass the same queue to 
the STATUS CHANGE REQUEST procedure and the REP ORT LOG ENTRIES 
procedure, the system allocates only one intercom queue for their use. 

Additionally, message control systems (MCSs) can use the DCALGOL 
SETUPINTERCOM function to explicitly initialize an intercom queue before passing 
it to the STATUS_CHANGE_REQUEST procedure. The SETUPINTERCOM function 
is discussed in the A Series DCALGOL Programming Reference Manual. 
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Detecting Queue Allocation Errors for 
STATUS^CHANGE^REQUEST 

STATUS CHANGE REQUEST is a real procedure that returns a value of-1 if the 
system cannot allocate an intercom queue slot for the procedure. This error occurs 
if the system has already allocated 47 intercom queues to user programs calling the 
STATUS_CHANGE_REQUEST and REPORT_LOG_ENTRIES procedures. 

Waiting for Event Messages 

The STATUS_CHANGE_REQUEST procedure exits once the system has inspected the 
SCEVENTS parameter and assigned the Q parameter to an intercom queue. Since the 
program declares the actual parameters globally to the STATUS_CH ANGE_RE QUE ST 
procedure, the actual parameters continue to exist after the procedure exits. The 
program can monitor the arrival of event messages by waiting on the QINSERTEVENT 
attribute of the DCALGOL queue that was passed to the Q parameter. The 
QINSERTEVENT attribute is discussed in the A Series DCALGOL Programming 
Reference Manual. 

Interpreting the Event Messages 

The event messages returned in the Q parameter are in an encoded format, with 
separate fields that indicate the type of event, the time of day, and sufficient 
information to uniquely identify the event. 

Note: The format of the event messages is heavily dependent on internal 
operating system structures. While care is taken to minimize format 
changes, Unisys reserves the right to change these message formats 
without a 3-release warning. 

All messages have the basic structure explained in Table 11-2. 



Table 11-2. Event Message Basic Format 



Word 


Contents 




0 


If you are using the same intercom queue for more than one purpose, 
you can inspect the contents of this word to determine if the message 
was inserted by STATUS_CHANGE_REQUEST or some other 
mechanism. 




Field 


Contents 




[47:08] 


Contains the value 21. 




[39:08] 


Contains the value 15. 



continued 
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Table 11-2. Event Message Basic Format (cont.) 



Word Contents 

[15:16] Contains a value identifying the type of 

event. The possible event types, and their 
meanings, are listed in Table 1 1-3, 
"Event Message Variable Formats." The 
value 20 is never used by 
STATUS CHANGE REQUEST; a value of 
20 in this field indicates that the message 
was inserted by REPORT LOG ENTRIES. 



1 Time of day in multiples of 2.4 microseconds. 

2 The size of the message starting in word 5. 

3 The date and time, in the same format as that returned by the 
TIME(7) function in ALGOL. The value is divided into the following 



fields: 




Field 


Contents 


[47:12] 


Year (1900 through 1999) 


[35:06] 


Month (1 through 12) 


[29:06] 


Day (1 through 31) 


[23.06] 


Hour (0 through 23) 


[17:06] 


Minute (0 through 59) 


[11:06] 


Second (0 through 59) 


[05:06] 


Day of the week (0 = Sunday, 1 = 




Monday, and so on) 



4 This word is not used. 

5-n Contents vary, depending on the event type reported in field [15:16] 

of word 0. Refer to Table 1 1-3 for information about these words. 
Word 6 duplicates the value from field [15:16] of word 0, unless 
otherwise specified in Table 1 1-3. 



Table 11-3 describes the portions of the event message format that vary according to 
the type of event that is being reported. The event types shown correspond to the value 
of field [15:16] of word 0. 
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Table 11-3. Event Message Variable Formats 



Event Type 


Word 


Contents 




1 (Process Scheduled) 


7 


Contains the SERIAL word for the scheduled process.! 


2 (Non-WFL Process 
Initiated) 


7 


Contains the SERIAL word for the task.t 


3 (Non-WFL Process 
Terminated) 


7 


Contains the SERIAL word for the task.t 




8 


Contains the value of the HISTORY task attribute of the 
task. For the format of this value, refer to the A Series 
Task Attributes Programming Reference Manual. 


4 (Priority Changed) 


7 


Contains the SERIAL word for the process. t 




8 


The new value of the PRIORITY task attribute. 


5 (RSVP Issued) 


7 


Contains the SERIAL word for the process.! 




8 


Bit 47 of this word is always set, indicating that the 
process is suspended. The following bits indicate the 
allowable responses: 






16 


NOTOK (Do Not Reactivate) system 
command 






15 


FA (File Attribute) system command 






14 


QT (Quit) system command 






13 


No response is necessary; the process 
is executing a DCKEYIN function and 
will resume automatically when the 
function is completed. 






12 


AX (Accept) system command 






11 


OK (Reactivate) system command 
(must be entered from an ODT) 






10 


OU (Output Unit) system command 






9 


UL (U n labeled) system command 






8 


FM (Form Message) system command 






7 


IL (Ignore Label) system command 






6 


CL (Clear) system command 






5 


SV (Save) system command 






4 


FR (Final Reel) system command 






3 


OF (Optional File) system command 



t For information about the SERIAL word format, refer to Table 1 1-4. continued 
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Table 11-3. 


Event Message Variable Formats (cont.) 


. a. mm. i ■ f J 

Event Type Word 


Contents 




2 OK (Reactivate) system command (can 
be entered from an ODT or a remote 
terminal) 




1 RM (Remove) system command 




0 DS (Discontinue) system command 


6 (Unit Status Changed) 7 


Field [11:12] contains the unit type of the unit that 
changed status. The values associated with each unit 
type are the same as the values documented for the KIND 
file attribute in the A Series File Attributes 
Programming Reference Manual. 


8 


Field [15:16] contains the unit number of the affected 
unit. 


7 (Tape Label Created) 5 


Contains the value 9. 


6 


Contains the value 7. 


7 


The SERIAL word for the process that created the tape 
label.t 


8 


Indicates which of the remaining words of the message 
store valid file attribute values. Each word stores a valid 
value if the corresponding bit of this word is set. To 
determine the bit number corresponding to a particular 
word, subtract 5 from the word number; thus, bit 4 
corresponds to word 9. 


9 


The SAVEFACTOR file attribute value. 


10 


The DENSITY file attribute value. 


11 


Field Contents 

[37: 14] The CYCLE file attribute value. 
[23:08] The VERSION file attribute value. 
[14:15] The FILESECTION file attribute value. 


12 


The index, relative to word 5, of the word where the tape 
file title begins. (Add 5 for the correct index.) The tape 
file title is stored in standard form4 


13 


The SERIALNO file attribute value. 


14 


The UNITNO file attribute value. 


t For information about the SERIAL word format, refer to Table 1 1-4. continued 



$ For information about standard form, refer to the description of the 
DISPLAYTOSTANDARD function in the A Series DCALGOL 
Programming Reference Manual. 
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Table 11-3. Event Message Variable Formats (cont.) 



Event Type 


Word 


Contents 




15 


The KIND file attribute value. 




16 


The index, relative to word 5, of the word where the 
NAME task attribute of the job is stored. (Add 5 for the 
correct index.) The NAME value is stored in standard 
form.t 




17 


The index, relative to word 5, of the word where the 
NAME task attribute of the process opening the file is 

MUIcU. \MUU O IUI U Ic CUIIcUl IIIUtJA./ NIC INMIVIC ValUc lb 

stored in standard form.t 




18-/1 


Information pointed to by words 12, 16, and 17. 


9 (Database User Count 
Changed) 


7 


Contains the SERIAL word for the database stack. t 




8 


The number of user processes with that database open. 


10 (WFL Available) 


None 
affected 




11 (\ ihrarv Frn7p^ 

XX \L.lUlQiy 1 IUi.C/ 


7 


1 1 Ic OCnlnL WvJIU IUI IMC llUICiiy piUUCoo. | 


12 (Process Initiation) 


5 


Information for internal use by the operating system. 




6 


The SERIAL word for the process.! 




7 


The PRIORITY task attribute value of the process. 




8 


Not used. 




9-11 


The USERCODE task attribute of the process. 
Field [47:08] of word 9 stores the length of the usercode. 
The usercode itself starts at bit 39 of word 9, and can 
extend through words 10 and 11. 




12-14 


The compiler name, if this is a compilation. Field [47:08] 
of word 9 stores the length of the compiler name. The 
compiler name itself starts at bit 39 of word 9, and can 
extend through words 10 and 11. 




15-n 


The NAME task attribute of the process, expressed in 

standard form.+ 


13 (Library Thawed) 


7 


The SERIAL word for the library process.t 


14 (WFL Job Queued) 


7 


The MIXNUMBER task attribute of the WFL job. 




8 


The CLASS task attribute of the WFL job. 


15 (WFL Job 
Discontinued from 
Queue) 


7 


The MIXNUMBER task attribute of the WFL job. 



t For information about the SERIAL word format, refer to Table 1 1-4. continued 
$ For information about standard form, refer to the description of the 

DISPLAYTOSTANDARD function in the A Series DCALGOL 

Programming Reference Manual. 
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Table 11-3. Event Message Variable Formats (cont.) 



Event Type 


Word 


Contents 


16 (Data Comm Tables 
Built) 


None 
Affected 




17 (Data Comm Tables 
Deallocated) 


None 
Affected 




18(WFLJob Initiated) 


7 


The SERIAL word for the WFL job.t 


19 (WFL Job Terminated) 


7 


The SERIAL word for the WFL job.t 


21 (System Command or 
Response) 


5 


The time of day, expressed in units of 2.4 microseconds. 




6-n 


The system command or response text. The text is 
expressed as EBCDIC characters, but can include 
undisplayed characters that are used to control the 
operator display terminal (ODT). 


22 (Process Terminated) 


6 


The SERIAL word for the process. t 




7 


The HISTORY task attribute of the process. 




8 


The STOPPOINT task attribute value of the process. For 
information about STOPPOINT, refer to the A Series 
Task Attributes Programming Reference Manual. 




9-10 


These words are reserved for future use. 




11-13 


The USERCODE task attribute of the process. 
Field [47:08] of word 1 1 stores the length of the 
usercode. The usercode itself starts at bit 39 of word 11, 
and can extend through words 12 and 13. 




14 


Index to the location of the compiler name, if this process 
is a compilation. You must add 5 to the value stored here 
to determine the correct word index. If the process is not 
a compilation, this word stores a 0 (zero). 




15-19 


Information for internal use by the operating system. 




20 


The beginning of the NAME task attribute of the process, 
expressed in standard form4 



t For information about the SERIAL word format, refer to Table 1 1-4. 

t For information about standard form, refer to the description of the 
DISPLAYTOSTANDARD function in the A Series DCALGOL 
Programming Reference Manual. 
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Table 11-3, "Event Message Variable Formats," includes several references to the 
SERIAL word. Table 11-4 describes the format of this word. 

Table 11-4. SERIAL Word Format 



Field 


Contents 


[15:16] 


The mix number of the process. 


[31:16] 


The mix number of the job for the process. 


[47:12] 


The stack number of the process. 
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STATUS CHANGE REQUEST User Program Example 

The following program uses the STATUS_CHANGE_REQUEST procedure to monitor 
the initiation of processes. An explanation follows the program. 

100 $INSTALLATION 1 

105 % ************************************** 

110 % % 

115 % PROGRAM: BOJ AND BOT NOTICE % 

120 % DESCRIPTION: WHENEVER A PROCESS BEGINS, THIS PROGRAM SENDS % 

125 % INFORMATION CONCERNING THE PROCESS TO THE SCREEN % 

130 % % 
135 % ****************************************************************** 

140 

145 BEGIN 
150 

155 LIBRARY MCP(LIBACCESS=BYFUNCTION, FUNCTIONNAME="MCPSUPPORT") ; 

160 REAL PROCEDURE STATUS_CHANGE_REQUEST (Q, SCEVENTS) ; 

165 ARRAY SCEVENTS [*]; 

170 QUEUE Q; 

175 LIBRARY MCP; 

180 

185 DEFINE 

190 PROGNAMEMSGSIZE = [47:8] #, 

195 TASKNO = [15:16] #, 

200 JOBNO = [31:16] #, 

205 BOJNOTICE = [12:1] #, 

210 MIXNUMSIZE = 6 #, 

215 MAXEVENTS = 100 #, 

220 MAXQENTRIES = 100 #, 

225 MAXMSGSIZE = 100 #, 

230 TIMESIZE = 8 #, 

235 LINESIZE = 80 #, 

240 SCREENSIZE = 24*80 #, 

245 SERIALI = 6 #, 

250 PROGNAMEMSGI = 15 #, 



255 TIMEI = 1 #; 
260 

265 INTEGER JOBNUM, 

270 TASKNUM; 

275 POINTER PMPTR, 

280 PPTR, 

285 TPTR, 

290 OPTR; 

295 ARRAY SCEVENTS [0:MAXEVENTS-1] , 

300 PROGNAMEMSG[0:MAXMSGSIZE-1] , 

405 PROGNAME[0:MAXMSGSIZE-1], 

410 THETIME[0:TIMESIZE-1], 

415 OUTPUT[0:LINESIZE-1], 

420 QENTRY[0:MAXQENTRIES-1] ; 

425 QUEUE Q; 

430 FILE STDIO (KIND = REMOTE, 
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435 MYUSE = 10, 

440 MAXRECSIZE = SCREENSIZE, 

445 UMTS = CHARACTERS, 

450 BLOCKSTRUCTURE = EXTERNAL); 

455 

460 PROCEDURE PUT_TIME(PTR, TIM); 

465 VALUE TIM; 

470 REAL TIM; 

475 POINTER PTR; 

480 BEGIN 

485 TIM := TIM * 2.4(3-6; 

490 REPLACE PTR BY TIM DIV 3600 FOR 2 DIGITS, " : " , 

495 TIM MOD 3600 DIV 60 FOR 2 DIGITS, 

500 TIM MOD 60 FOR 2 DIGITS; 

505 END PUT_TIME; 

610 

615 

620 SCEVENTS[0].BOJNOTICE := 1; 
625 

630 IF (STATUS_CHANGE_REQUEST (Q , SCEVENTS) < 0) THEN 

635 WRITE(STDIO, SCREENSIZE, "ERROR: INTERCOM QUEUE SLOT UNAVAILABLE") 

640 ELSE 

645 BEGIN 

650 WRITE(STDIO, SCREENSIZE, "PROGRAM INITIALIZED"); 

655 WHILE TRUE DO 

660 BEGIN 

665 WRITE (STDIO, SCREENSIZE, "...WAITING FOR BOJ"); 

670 WAIT (Q.QINSERTEVENT); 

675 REMOVE (QENTRY, Q) ; 

680 REPLACE POINTER (PROGNAMEMSG) BY POINTER (QENTRY [PROGNAMEMSGI] ) 

685 FOR MAXMSGSIZE; 

690 PMPTR := POINTER (PROGNAMEMSG) ; 

695 PPTR := POINTER (PROGNAME) ; 

700 STANDARDTODISPLAY (PMPTR, PPTR); 

705 

710 JOBNUM := QENTRY [SERIALI] .JOBNO; 

715 TASKNUM := QENTRY [SERIALI] .TASKNO; 
720 

725 TPTR := POINTER(THETIME) ; 

730 PUT_TIME(TPTR, QENTRY [TIMEI] ) ; 

735 

740 OPTR := OUTPUT; 

745 REPLACE OPTR:OUTPUT BY "PROGRAM NAME: " ; 

750 REPLACE OPTR:OPTR BY POINTER (PROGNAME) 

755 FOR (LINESIZE-OFFSET(OPTR)) WHILE NEQ "."; 

760 WRITE(STDIO, OFFSET (OPTR) , OUTPUT); 

765 

770 OPTR := OUTPUT; 

775 REPLACE OPTR:OUTPUT BY " JOB#: " ; 

780 REPLACE OPTR:OPTR BY TASKNUM FOR MIXNUMSIZE DIGITS; 

785 WRITE(STDIO, OFFSET(OPTR) , OUTPUT); 

790 



11-12 



8600 0478-100 



STATUS CHANGE REQUEST 



795 
800 



OPTR := OUTPUT; 
REPLACE OPTR: OUTPUT BY 



TASK#: 



■i . 



805 REPLACE OPTR:OPTR BY TASKNUM FOR MIXNUMSIZE DIGITS; 

810 WRITE(STDIO, OFFSET (OPTR) , OUTPUT); 

815 

820 OPTR := OUTPUT; 

825 REPLACE OPTR: OUTPUT BY "TIME STARTED: "; 
830 REPLACE OPTR:OPTR BY TPTR FOR TIMESIZE; 
835 WRITE(STDIO, OFFSET (OPTR) , OUTPUT); 
840 END; 
845 END; 
850 END. 

You must mark the object code file as privileged with the MP (Mark Program) system 
command. 

The $INSTALLATION 1 statement at line 100 gives the program access to an 
installation intrinsic that supports the STANDARDTODISPLAY statement used later 
in the program. 

The statement at line 620 in this program turns on bit 12 in the SCEVENTS parameter, 
thus requesting notification of all process initiations that take place on the system. The 
meanings of the bits in this parameter are documented in Table 11-1, "Event Types," 
in this section. 

The statement at line 630 invokes STATUSCHANGERE QUEST as a function and 
checks to see if the result value is less than zero; if so, the system was unable to allocate 
an intercom queue, and the program displays an error message. 

If the intercom queue was allocated successfully, the program enters the WHILE loop 
at lines 655 through 840. The statement at line 670 causes the program to wait for a 
message to appear in intercom queue Q. The statement at line 675 causes the program 
to remove the message from the queue and place it in array QENTRY. 

The statements at lines 680 through 715 extract information from the message stored 
in QENTRY. These statements make use of the format information for event type 
12 (Process Initiation) that is documented in Table 11-3, "Event Message Variable 
Formats." 

Thus, lines 680 through 685 extract the process name beginning at word 15 of 
QENTRY. Because the process name is stored in standard form, the statement at line 
700 invokes STANDARDTODISPLAY to convert the name to display form. Line 710 
extracts the job number stored in field [31:16] of word 6. Line 715 extracts the task 
number stored in field [15:16] of word 6. 

Line 730 extracts the time of day from word 1 of QENTRY. This portion of the message 
format is documented in Table 11-2, "Event Message Basic Format." The PUT_TIME 
procedure converts the time from units of 2.4 microseconds to an HH:MM:SS format 
for display. 

The remainder of the program displays the process name, job number, task number, 
and time at a remote terminal. 
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This section serves as a reference to users of the system log (SUMLOG) information on 
Unisys A Series systems. The system log is a disk file stored on the family designated 
by the DL SUMLOG form of the DL (Disk Location) system command. This log 
contains entries concerning jobs previously run, operating system activity, and other 
associated information regarding the past status of the machine environment. 

Understanding Log Releases 

Periodically, the system has to create a new SYSTEM/SUMLOG file and save the old 
SYSTEM/SUMLOG file under a different title. This action is referred to as a log 
release. The system performs a log release whenever any of the following situations 
occur: 

• When the existing SUMLOG becomes 95 percent filled. Because the SUMLOG file 
holds up to 100,000 records, an automatic log release takes place at approximately 
95,000 records. 

• When an operator enters a TL (Transfer Log) system command. 

• When an operator enters the DL LOG < family > form of the DL (Disk Location) 
system command. 

When the system performs a log release for any of these reasons, the system changes 
the title of the existing SYSTEM/SUMLOG file to a title of the following form: 

SUML06/<system serial number>/<date>/<l og number> 

In this title format, the <log number > is a 6-digit integer that is one greater than that 
used at the previous log release. The operating system maintains the <log number> in 
a table on the halt/load family. The <log numbers > increase until the next cold-start 
or until a new halt/load family is used. 

Controlling Log Contents 

The information stored in the system log is grouped into units called log entries. Log 
entries are classified into various major types, based on the general type of information 
they store. Within each major type, log entries are classified into minor types based on 
the specific types of information they store. 

Each major type and minor type has both a name and a number. For example, log 
entries that record task initiations are Major Type 1 (Job or Task Entry), Minor Type 3 
(BOT). The system places a log entry of this type in this system log each time a task is 
initiated on the system. 
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The system administrator can control the contents of the system log in the following 
ways: 

•. By specifying which of the possible log entry types should be logged by the system 

• By specifying whether anonymous file accounting or anonymous task accounting 
should be used 

• By creating programs that insert installation-defined entries in the system log 
The following subsections describe these methods for controlling system log contents. 

Selecting the Entry Types to be Logged 

The LOGGING (Logging Options) system command can be used to control which 
log entries are logged in the system SUMLOG file and/or job file, including 
installation-defined entries that are written to the SUMLOG file. This way, the site 
manager can bypass unneeded information entries and minimize the volume of log 
entries. 

The default list of entry types to to be logged is given in the Default Log Option Setting 
column in Table 12-5, "Log Entry Classes," later in this section. Deviations from 
the default settings affect the system performance. Any event that is added causes 
a performance degradation, depending upon the frequency of the event occurrence. 
Directory actions (Major Type 16) are an example of a frequently occurring event. 
Conversely, any events that are deleted decrease the operating system time spent on 
logging, resulting in a performance improvement. It is recommended that at least the 
following events always be logged: 



Major Type Minor Type Event 

0 1 Establish identity (El) (Not selectable) 

1 1 Beginning of job (BOJ) 
1 2 End of job (EOJ) 

1 3 Beginning of task (BOT) 

1 4 End of task (EOT) 

2 All maintenance entries 

4 1 MCS session log-on (LOGON) 

4 2 MCS session log-off (LOGOFF) 

6 1 Halt/load entry 

6 3 SETSTATUS entry 

The LOGGING * form of the LOGGING command can be used to restore the default 
logging settings at any time. 
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The LG (Log for Mix Number) system command and the user structure element 
LOGSELECT (accessible through the MAKEUSER utility) can generate additional 
logging on specified tasks and usercodes. (LG is only available on an InfoGuard 
system.) This part of the selective logging mechanism can include additional audit 
information at a fraction of the cost that it takes to log the event at all times for all 
tasks. 

Requesting Copies of Configuration Files 

The system creates copies of certain configuration files whenever log entry types 
associated with those configuration files are issued. These configuration files include 
COMS load files, the DATACOMINF OFILE, guard files, and the USERD ATAFILE . You 
can use the LOGGING (Logging Options) system command to enable logging of the log 
entry types that cause these copies to be created. 

The copies of configuration files are created on the family specified by the DL LOGS 
option of the DL (Disk Location) system command. Each file has a title of the form 
"SUMLOG/<type>/<date>/<time>", where <date> and <time> are the date and 
time the copy was initiated. The <date> is in the format HHMMSS, and the <time> 
is in the format MMDDYY. The <type> value is determined from the major and minor 
type of the log entry as follows: 

Major/Minor 



Type Description <type> 

6,11 New USERDATA install USERDATAFILE 

16, 1 File creation and copy (The copy is made only if GUARDFILE | 

the file is a guard file.) 

17,2 Data com m installation and copy DATACOMINFO 

18,12 Load file copy COMSLOAD 



For the format of these log entries, refer to "Log Entry Types" later in this section. 

Using Anonymous Task and File Accounting 

Anonymous task accounting and anonymous file accounting are two methods of 
improving system performance by reducing the number of log entries the system 
generates. 

A process is eligible for anonymous task accounting if all the following conditions are 
true: 

• The process is a task— that is, a dependent process. 

• The process has the same usercode as its parent. 

• The process is not initiated directly from a CANDE or MARC session or from a 
WFLjob. 

If anonymous task accounting is in effect for a particular task, the system does not 
create Major Type 1, Minor Type 3 (BOT) or 4 (EOT) log entries for that task. Further, 
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the system does not issue BOT or EOT system messages for the task, and the task does 
not appear in the C (Completed Mix Entries) system command display. 

All user processes are eligible for anonymous file accounting. If anonymous file 
accounting is in effect for a particular process, the system does not create Major Type 1, 
Minor Type 5 (File Open) or 6 (File Close) log entries for that process. Instead, the 
system issues a Major Type 1, Minor Type 25 (File Statistics) entry when the process 
terminates. 

If anonymous task accounting and anonymous file accounting are both in effect for a 
particular process, then the system does not issue the File Statistics entry when the 
process terminates. Instead, the system adds the statistics to the File Statistics entry 
that is issued when the parent terminates. 

A programmer can use the DEPTASKACCOUNTING and FILEACCOUNTING task 
attributes to request anonymous task accounting or anonymous file accounting for a 
process. The system administrator can use the ACCOUNTING (Resource Accounting) 
system command to specify a systemwide default value for these task attributes. 
The system administrator can also specify default DEPTASKACCOUNTING and 
FILEACCOUNTING values in individual usercode definitions. For further information 
about these task attributes, refer to the A Series Task Attributes Programming 
Reference Manual. 

Defining Installation Log Entries 

Most log entries are generated and handled internally by the MCP. Entries generated 
internally call the MCP procedure WRITELOG. The MCP procedure WRITELOG is 
used to mark log entries with a timestamp and send them to the system log file and to 
the job file, if available. 

Selected entries are generated outside the MCP Software outside the MCP cannot write 
to the SUMLOG directly, because the SUMLOG is marked by the MCP as a read-only 
file. However, software outside the MCP can generate log entries by calling MCP 
library object MCP_LOGGER, which is also available as the intrinsic MCSLOGGER. 

| Log entries generated by MCP LOGGER or MCSLOGGER cannot exceed 1023 words 

in length. 
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MCPLOGGER can be used to log the following events, shown in Table 12-1 according 
to the capabilities and identity of the calling program: 



Table 12-1. Events Logged by MCP LOGGER 



IVIclJUl 

Type 


Minnr 

Type 


Entry Class 


Caller Status 


4 


ALL 


MCS 


MCS, SSL, IR 


6 


7 


MISCELLANEOUS Controller 
Command 


IR 


7 


ALL 


INSTALLATION 


MCS, SSL, IR, PU 


11 


ALL 


BNA 


SSL 


13 


ALL 


BNA Version 2 


SSL 


18 


ALL 


COMS CONFIGURATION 


MCS, SSL, IR 


25 


ALL 


HLCN 


PU 


27 


ALL 


TCP/IP 


PU 


28 


ALL 


NMS 


PU 


30 


ALL 


SNA 


PU 



Legend 

MCS Message control system (CANDE, COMS, or MARC) 

SSL System support library-BNA 

IR Independent runner (CONTROLLER) 

PU Privileged program 



The following example program logs an installation entry using MCP_LOGGER It 
identifies the syntax and illustrates the use of the external logging interface from an 
ALGOL program. It must be a privileged program. 

BEGIN 

LIBRARY MCPSUPPORT(LIBACCESS=BYFUNCTION) ; 
BOOLEAN PROCEDURE MCP_LOGGER(LEN,REC) ; 
VALUE LEN; 
INTEGER LEN; 
ARRAY REC[*]; 
LIBRARY MCPSUPPORT; 
DEFINE 

LOGTYPEX = 3 #, 

ERR_ANY FAULT = ALL1 #, 

ERR_T00_L0NG = 1 #, 

ERR_MCS = 2 #, 

ERR_N0T_ LOGGED = 3 #, 

ERR_MAJ0R = 4 #, 

ERR_MIXNUMBER = 5 #, 

ERR_JOBFILE = 6 #, 

ERR TOO SHORT = 7 #, 
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ERR_BADLINK = 8 #, 

LOGFIXEDLENF= [47: 6] #, 

LOGLENGTHF = [41:10] #, 

LOGRESULTF = [31: 2] #, 

LOGVISIBLEF = [29: 2] #, 

LOGMAJORF = [27:12] #, 

LOGMAJINST = 7 #, 

LOGMINORF = [15:16] #; 

ARRAY LOG_ENTRY[0:29] ; 

BOOLEAN BOOL; 

REAL RSLT; 



%%%% SET UP CONTENTS OF LOG_ENTRY [4] END 

%%%% ASSUME TOTAL LENGTH = 30; LENGTH OF FIXED PART = 6; 

LOG_ENTRY [LOGTYPEX] := 0 & 6 LOGFIXEDLENF 

& LOGMAJINST LOGMAJORF 
& 12 LOGMINORF; 

IF BOOL := MCP_LOGGER(30,LOG_ENTRY) THEN 
BEGIN 

RSLT := REAL (BOOL) . [11:8] ; 

DISPLAY ("MCP_LOGGER CALL ERROR " !! STRING (RSLT ,*)) ; 
END; 
END. 



Using Log Analysis Utilities 



Several utilities are available for analyzing and reporting on system log and job log 
contents. You can modify the output of some of these utilities by creating a support 
library that customizes log analysis. 



Using Standard Utilities 

The following are log analysis utilities and features provided by Unisys: 



Utility 

LOGANALYZER 



LOGGER 



Explanation 

This utility reports the contents of selected types of log entries. 
LOGANALYZER is well suited for historical reporting and security 
auditing. For further information, refer to Section 7, 
"LOGANALYZER." 

This utility reports on totals and averages of information contained 
in selected types of log entries. LOGGER is well suited to billing and 
workload analysis. For further information, refer to Section 8, 
"LOGGER." 

continued 
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continued 



Utility 



Explanation 



System Management 
Facility II (SMFII) 



The LOGCONSOLI DATOR component of SMFII extracts workload 
analysis and hardware reliability information from the system log. 
The QUERY component of SMFII can analyze and format this 
information into a wide variety of reports. For further information, 
refer to the A Series System Management Facility II 
(SMFII) Resource Management Operations Reference 
Manual and the A Series System Management Facility II 
(SMFII) Query Operations Guide. 



JOBFORMATTER 



This system library generates job summaries when jobs terminate. 
For information about how to control the issuing of job summaries, 
refer to the process history discussion in the A Series Task 
Management Programming Guide. 



Customizing Log Analysis 

In addition to producing job summaries, JOBFORMATTER exports procedures 
that LOGANALYZER uses to perform log analysis. You can customize the analysis 
performed by JOBFORMATTER, and hence the contents of job summaries and 
LOGANALYZER reports. 

To customize JOBFORMATTER log analysis, you must write a support library called 
SITESUPPORT that exports a procedure called PINSTALLATION. JOBFORMATTER 
attempts to call the PINSTALLATION procedure; if the first call is successful, 
JOBFORMATTER calls PINSTALLATION for each job log or system log entry. If the 
PINSTALLATION procedure returns a result indicating that it did not analyze the 
entry, JOBFORMATTER performs its standard analysis; otherwise it skips the entry. 

The following actions must be taken in order for site-customized log analysis to be 
implemented: 

First, the site analysis code must be contained in a library program as a real typed 
procedure. Its interface is declared (using ALGOL) as follows: 

REAL PROCEDURE PINSTALLATION (LBUF,BUF,GL_RTLINE, INFO) ; 
VALUE INFO; 
ARRAY LBUF,BUF[*]; 
PROCEDURE GL_RTLINE(N); 



VALUE N; 
REAL N; 
FORMAL; 



REAL INFO; 
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The parameters are described as follows: 
Parameter Description 



LBUF 
BUF 

GLRTLINE 

INFO.[47:47] 
INFO.tO: 1] 

< return value> 



The output buffer used by GL_RTLINE. LBUF is 43 words long. 
When GLRTLINE is called, it writes the first 132 characters of the 
buffer. If there are nonblank characters beyond byte 132 in LBUF, 
then GL_RTLINE writes them on succeeding print lines as needed. 

Contains a complete log entry for analysis. 

The output routine. IF N = 0 THEN LBUF is written; if N > 0 then 
N blank lines are written. This procedure can be called as many 
times as needed for complete analysis of the log entry. 

Not used. 

Analysis requestor. If this bit is off, then the analysis is for a job file 
summary. If this bit is on, it is a call by LOGANALYZER for a system 
summary log. 

If the <return value> is 0, then the log entry was not analyzed; if it 
is 1, then the log entry was analyzed. 



This procedure should analyze and report the log entry in BUF by calling the output 
procedure GL_RTLINE one or more times, passing the analyzed text in LBUF, 
and using the information in INFO. Note that since the user of PINSTALLATION 
is the SHAREDBYALL library JOBFORMATTER, the effective sharing of the 
SITESUPPORT library is therefore SHAREDBYALL, regardless of the declared 
sharing in the library itself. 

The library must be installed as the support function SITESUPPORT, using the SL 
(Support Library) system command. 



Writing Log Analysis Programs 

If you need log analysis capabilities significantly different from those provided by 
A Series utilities, you can write your own log analysis application. Before writing an 
application, you need to understand the log structure information presented in the 
following subsection. 

Depending on the security configuration of your system, your log analysis application 
might be able to read the system log directly, or the application might have to use the 
SDASUPPORT library interface to read the system log. Details of this interface are 
given under "Using the SDASUPPORT Library" later in this section. 

Understanding Log Structure 

The system log, SYSTEM/SUMLOG, is designed by default as a protected disk file of 
up to 99 rows of 1000 segments per row, consisting of a varying number of 30-word 
physical records. The following subsections explain 

• The relationship between logical log entries and physical records 

• The contents of the first four words of each entry 
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• The order in which entries are placed in the log 

• The format of LINK words used in log entries 

• How to write an application that runs successfully even if the format of log entries 
changes 

Understanding Log Entries and Physical Records 

The number of words of information in each entry differs not only for the different log 
entry types but also between specific entries of the same type (because they include 
program names, file names, and other variable-length information). The exact number 
of records in an entry is entered in the first word (word 0, field [39:8]) of the 30-word 
record of the entry. The length of the entry in words is contained in field [41:10] of 
Word 3 for entries containing up to 1022 words. For entries that are 1023 words 
or longer, the field has all ten bits on. In this case, use the format of the log entry, 
described in "Log Entry Types" later in this section, to determine the length of the log 
entry. 

The log is organized so that bad information in one record or a disk error does not 
hamper retrieval of other records. According to this organization, all logical log entries 
are split into contiguous, fixed-size physical records of 30 words each. The first word of 
every physical record contains a record group description that describes its position in 
the logical log entry. The MCP procedure WRITELOG breaks up the logical log entry 
into physical log records. 

When analyzing the log, a program must reassemble the logical entry from the physical 
records found in the log before it uses the word numbers listed for the log entries 
under "Log Entry Types" in this section. Those word numbers refer to the words as 
contained in the logical entry, not as they occur after the entry has been broken up into 
physical records. 

The relationship between the words of the logical entry and their location in the 
physical log record is shown in the following table: 

Physical Record 

Number Physical Record Word 0 Logical Entry Data Words 

1 Record 1 of 3 0-29 

2 Record 2 of 3 30-58 

3 Record 3 of 3 59-87 



Understanding the First Four Words 

The first four words (0 through 3) of every logical log entry contain the information 
shown in Table 12-2, "First Four Log Entry Words." Note that the record group 
description is found in Word 0 of every physical log record as well as in Word 0 of the 
logical log entry. 



8600 0478-110 



12-9 



SUMLOG 



Table 12-2. First Four Log Entry Words 



Word 


Dpcrrintinn 


o 


Record group description 




T47* 81 The cardinality of this record within the logical lot? entrv ("this is 

L i / • v j ii iw vciiuii icji ny vl 11 II <J 1 UW1 VJ VVIWIIIII 1 1 IV* lUgl wCI 1 IV/g Wlllly V 11 1 1 0 IO 




record m of n") beginning with 1 




[39: 8] The total number of physical records in this logical log entry 




[31:16] The JOBNUMBER value of the process that caused the log entry 




[15:16] The MIXNUMBER value of the process that caused the log entry 


1 


Julian date in binary 


2 


Time of day, in units of 2.4 microseconds 


Q 

o 


LUg ciiuy type tuuc 




[47: 6] Length of fixed part of entry in words 




[41:10] Length of the entire log entry in words, unless all the bits are on 




(value equal to 1023), in which case the entry is longer than 1022 words. 




For these long entries, use the format described in "Log Entry Types" later 




in this section to determine the length of the log entry. 




[31: 2] Result indicator (InfoGuard only) 




0 = Successful actions that are not security relevant 




1 = Failed actions that are not security violations 




2 = Successful actions that are security relevant, including SETSTATUS 




entries requiring security administration; ??SECAD primitive; security 




attribute assignments (volume and directory); attachments of guard files to 




files; USERDATA changes; BOJ/BOT/LOGON of privileged user, security 




administrator, or privileged program 




3 = Failed actions that are security violations, including general security 




violations and MCS security violations 




[29: 2] Record visibility (InfoGuard only) 




0 = Unspecified 




1 = Public-maintenance and halt/load records 




2 = Private-records that are not public or secured 




3 = Secured-MCS security violations 




[27:12] Major type. This value gives a general indication of the type of log 




entry. 


continued 
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Table 12-2. First Four Log Entry Words (cont.) 



Word 


Description 




[15:16] Minor type. This value indicates the specific log entry type. Note 




that minor type values are unique only within a given major type. For a list 




of log types, refer to Table 12-5, "Log Entry Classes." 



Understanding Variations from Chronological Order 

The physical records of each log entry are always contiguous in the SUMLOG. However, 
these entries are not always logged in strict chronological order. Aside from the effects 
of the TR (Time Reset) and DR (Date Reset) system commands, unusual timestamps 
might occur when a halt/load is done after part of the system has been powered off and 
on. Furthermore, when contention occurs over which task is to write to the log next, 
the entries are made in the order of the task's priorities, not in the time sequence of 
their requests. The physical records of a single log entry are never split across two 
different logs, even if the TL (Transfer Log) system command was entered while 
the entry was being written. Entries are always made in the current SUMLOG file. 
Therefore, entries for a single job or task can occur in all the SUMLOG files that were 
active while the job or task was running. 

Understanding the LINK Words 

Each log entry is divided into a fixed part and a variable part. All items of information 
are given a reserved location in the fixed part. However, this location is not adequate to 
contain items such as task names and file titles, whose sizes vary. In these cases, the 
location in the fixed part is used to contain a LINK to the actual information, which is 
placed in the variable part of the log entry. Because all the fixed information precedes 
the variable information, items or their LINKs are always found at the same index in 
the fixed part, and for any given level of the log, all records of the same type have the 
same fixed-part size and structure. 

The consistency in indexing of the fixed part of a given type of entry helps preserve 
upward compatibility between Mark releases because new items of log information 
are always added at the end of the fixed part and are thus invisible to log programs 
that do not expect to find them. Downward compatibility is somewhat more difficult to 
achieve because analysis programs must first check the length of the fixed part in order 
to determine if the information they seek is present in the version of the log under 
analysis. 

Several formats exist for the LINK word used to refer to variable-length information. 

These include a standard LINK word format and specialized LINK formats for 

Hardware and Software Configuration records, I/O Exception records, BNA, and | 

Volume Directory records. These formats are discussed in the following subsections. 
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Format of Standard LINK Words 

This standard format for the LINK provides a word index to the start of the 
variable-length information and is the format referred to whenever the word LINK 
occurs in most log-entry descriptions. The layout of the LINK word is shown in 
Table 12-3, "Link to Variable Items." 



Table 12-3. Link to Variable Items 



Field 


Meaning 


[39:20] 


Length of this item in words. 


[19:20] 


Index of word in log entry where this item starts. It is found in the 
variable part of the log entry. 



Format of Hardware and Software Configuration LINK Words 

Major Type 2, Minor Type 17 (Hardware Configuration) and 18 (Software 
Configuration) entries require a LINK containing more information than the standard 
LINK contains. This additional information includes the type of variable-length data 
referred to and the amount of data available. To accommodate this information, a 
special format for a LINK word and a structure for a log record using these LINKs has 
been defined. The layout of this LINK word is as follows: 



Field 


Meaning 


[47: 8] 


LINKTYPE 


[39: 4] 


LINKVERSION 


[35:12] 


ITEM_COUNT 


[23: 8] 


ITEMWIDTH 


[15:16] 


START! NDEX 



This type of LINK describes a contiguous group of array entries known as a region. 
LINKs can appear within a region that is described by a LINK; this recursive use 
creates a tree structure. This LINK structure is described in the following paragraphs. 

The LINK_TYPE field of the LINK specifies the kind of information encoded in this 
region. 

The LINK_VEESION field identifies the version of the format of the information. 
Unisys changes the LINK_VERSION when the offset or format of an item changes 
between system Mark releases. 

The STAET_INDEX field of the LINK specifies the array index, in words, where the 
region described by the LINK starts. Specific items residing in the region have specific 
offsets from the STARTJNDEX of that region. 
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The ITEM_COUNT field contains the number of items found in the region described 
by the LINK. 

Regions can be either homogeneous or heterogeneous. If a region is homogeneous, 
all items that it contains must have the same size and format. The size is stored in 
the ITEM_WIDTH field of the LINK The ITEMJWIDTH value might be in units 
of words or bytes, depending on the LINK_TYPE. To determine the units used for 
ITEM_WIDTH for a given LINKTYPE, refer to the description of that particular 
LINK_TYPE. 

If the region is heterogeneous, the ITEM_WIDTH field is 0 and the ITEM COUNT is 
given in words. 

The direct part of a structure contains entries with a known fixed offset. The indirect 
part of a structure must be reached by following LINKs from a direct part. An indirect 
part can become a direct part when the LINK describing the indirect part is followed. 
This direct part has all the properties of any other direct part. 

Every user program should always verify that the LINKTYPE and LINKVERSION 
fields contain the expected values. If they do not, the program should not attempt to 
decode the information. The ITEM_COUNT field should be checked to verify that 
the expected number of items is present. The ITEM_WIDTH field should also be 
checked to verify that the item size conforms to the initial specifications. As long as 
the LINK_TYPE and LINKVERSION match the values that the decoding program 
expects, the data are in a format that the program understands. The ITEM_COUNT or 
ITEM_WIDTH, or both, can be larger or smaller than expected. The program should 
be coded to ignore any extra data in an item or unexpected items in a region. 

Format of I/O Exception LINK Words 

Major Type 2, Minor Type 21 (I/O Exception) entries make use of a LINK word with 
the following format: 



Table 12-4. I/O Exception LINK Word Format 



Field 


Meaning 


[47:16] 


Version. 


[31:16] 


Length of the item. 


[15:16] 


Offset of the word where the item starts. 



Format of BNA and HLCN LINK Words 

Major Type 11 (BNA) and Major Type 25 (HLCN) entries use a LINK word format that 
is almost the same as the standard LINK format. The only difference is that, in BNA 
and HLCN LINK words, the length field is usually given in units of bytes rather than 
words. These LINK words are specified to be either of type byte or type word in the 
record descriptions for these major types. 
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Format of Volume Directory LINK Words 

For Major Type 15, Minor Types 6 through 11 (Volume Directory) entries, the link 
format is as follows: 

Field Meaning 

[23:12] Length of the item in words 

[11:12] Index to the start of the item, minus 3. 

Preparing for Log Entry Format Changes 

In general, the log entry formats described in this section are taken from the current 
system software release. However, some log entry types that are no longer used on the 
current release continue to be documented in this section. This section also documents 
some individual words and fields that are no longer used. This information is retained 
to assist people in the analysis of system logs generated under the previous system 
software release. This section makes no attempt to document log entry types, words, or 
fields that have been unused for two or more Mark releases. 

Note: Although every effort is made to keep the fields as described in this 
section, new system software releases can introduce new log entry 
types or add new words to an existing log entry. Because of this fact, 
you should write log analysis programs to handle unrecognized 
major and minor types. 

The addition of new words to existing log entries is typically transparent to existing log 
analysis programs, because words are normally added at the end of the fixed part of the 
record. For example, in the BO J record, additions would be made after the nineteenth 
word. A log analysis program can determine the current length of a log entry by 
checking the length field of Word 3. 

The information in this section applies equally to all A Series systems except where 
otherwise noted. 

Understanding Log Access Security 

The ability of a process to read from the SUMLOG depends to some extent on whether 
the process has direct read access to the SUMLOG file. A process receives direct read 
access if at least one of the following conditions is true: 

• The process is privileged. 

• The SUMLOG file has a SECURITYTYPE file attribute value of PUBLIC. 

• The SUMLOG file has a SECURITYTYPE file attribute value of GUARDED or 
CONTROLLED, and has an associated guard file that allows the process read 
access to the log. 

The SECURITYTYPE value of the system log file is inherited from the old log file 
when a new log file is created. The default SECURITYTYPE value is specified by 
the NONUSERFILES system security option, which can have a value of PUBLIC or 
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PRIVATE. You can use the SECOPT (Security Options) system command to assign 
system security options such as NONUSERFILES. 

A process with direct read access to the system log file can read the log by simply 
opening the log file and executing read statements. A process with direct read access 
can also read the log file indirectly by invoking procedures in the SDASUPPORT 
library. 

If a process lacks direct read access to the system log file, and InfoGuard security 
enhancement software is not installed on the system, the process cannot read the 
system log at all. If InfoGuard security enhancement software is installed, the process 
can read the system log by invoking procedures in the SDASUPPORT library. However, 
the SDASUPPORT library performs filtering that limits the log entries visible to the 
process. 

For more information about the SDASUPPORT library, and the filtering it performs, 
refer to the following subsection. 

Using the SDASUPPORT Library 

The SDASUPPORT system library provides a generalized interface to any SUMLOG 
file. The SDASUPPORT library is used by LOGANALYZER, LOGGER, and SMFII 
to access log files. The SDASUPPORT library can also be used by any application 
program that reads a SUMLOG file. 

To install the SDASUPPORT library on non-InfoGuard systems, use the SL 
(Support Library) system command to associate *SYSTEM/SDASUPPORT with the 
function SDASUPPORT. On InfoGuard systems, use the SL command to associate 
*SYSTEM/IGSDASUPPORT with the function SDASUPPORT. 



Understanding SDASUPPORT Filtering 

On non-InfoGuard systems, only processes with direct read access to the log can use 
SDASUPPORT. The user process has access to all the export objects described under 
"Objects Exported by SDASUPPORT," later in this section. However, the following 
values cannot be used for the STYPE parameter to the LOG_SELECT function: 3 
(USERCODE SET), 4 (ACCESS CODE SET), 5 (FILTERING SET), 6 (RESULT SET), 
and 7 (CHARGECODE SET). These values return an error. SDASUPPORT does not 
perform any filtering on non-InfoGuard systems. 

On InfoGuard systems, all processes can use SDASUPPORT. The user process has 
access to all the export objects described under "Objects Exported by SDASUPPORT," 
later in this section. The user process can use the LOG_SELECT procedure to request 
filtering based on usercode, access code, or charge code. Filtering causes only log 
entries generated by processes with the specified usercode, access code, or charge code 
to be visible. 
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Note: By default, SDASUPPORT performs filtering based on the usercode 
of the user process. This is true regardless of whether the user process 
has direct read access to the system log. Processes that have direct 
read access can disable usercode filtering by invoking LOGJSELECT 
with an STYPE value of 3 (USERCODE SET) and an SBUFFER 
value of48"00". Processes that lack direct read access are not allowed 
to disable usercode filtering. 

Objects Exported by SDASUPPORT 



The SDASUPPORT library exports the following procedures: 



Procedure Name 


Function 


LOGATTRIBUTE 


Reads selected log file attributes 


LOG_CLOSE 


Closes the log file 


LOGGET 


Reads the next visible log file entry 


LOG_OPEN 


Sets the title and opens the log file 


LOGREAD 


Reads the next visible log file record 


LOGSEEK 


Seeks the log file record 


LOGSELECT 


Selects access modes for the log file 


LOG_SKIP 


Skips log file records 


SDASUPPORTVERSION 


Returns the version of the SDASUPPORT library 



The following subsections discuss the procedures exported by SDASUPPORT. 



LOGATTRIBUTE 

The LOG ATTRIBUTE procedure reads selected file attributes of the SUMLOG file. 
The procedure is set up as follows: 

INTEGER PROCEDURE LOG_ATTRIBUTE(ATT,ATTPTR) ; 
VALUE ATT,ATTPTR; 
INTEGER ATT; 
POINTER ATTPTR; 



In this procedure, the ATT parameter specifies the file attribute number of the file 
attribute that is being interrogated. In languages such as ALGOL and COBOL 74, 
the VALUE function can be used to return the number of a file attribute; for 
example, the ALGOL expression VALUE (FILEKIND) returns the attribute number 
58. For a complete list of file attribute numbers, refer to the A Series File Attributes 
Programming Reference Manual. 

For integer and mnemonic file attributes, the procedure result contains the value of 
the attribute. For character string file attributes, the procedure result contains the 
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length of the attribute value, and the value itself is returned at the location pointed to 
by ATTPTR. 

The file attributes that can be interrogated are 

• AREASIZE 

• BLOCKSIZE 

• LASTRECORD 

• MINRECSIZE 

• MAXRECSIZE 

• NEXTRECORD 

• RECORD 

• SECURITYGUARD 

• SECURITYTYPE 

• SECURITYUSE 

• TITLE 



If LOG_ATTRIBUTE is used to interrogate any other file attributes, a value of -1 is 
returned as the procedure result. 

If the TITLE file attribute is interrogated, and the selected log file is the current 
system SUMLOG file, then bit [47:1] of the procedure result is set. The procedure 
result also contains the length of the TITLE value. 

LOG_CLOSE 

The LOG_CLOSE procedure closes a log file and is set up a follows: 
INTEGER PROCEDURE L0G_CL0SE; 



The results are as follows: 

Value Meaning 

0 File closed 



LOGGET 

The LOG_GET procedure returns the next visible entry in the log file. The procedure 
is set up as follows: 

BOOLEAN PROCEDURE L0G_GET (BUFFER) ; 
ARRAY BUFFER [0] ; 
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The parameter for this procedure is a buffer for the return of the complete log entry. 
The procedure returns the read logical result descriptor if the log was opened, or an 
end-of-file (EOF) condition if the log was not opened. 

It is better to use the LOG_GET procedure rather than the LOG_READ procedure 
because the LOG_GET procedure returns a complete log entry. The BUFFER array is 
resized if necessary for the entry to fit. The return value contains the length of the 
entry, in words, in field [47:20]. 



LOG_OPEN 

The LOG_OPEN procedure sets the title and opens a log file with the given title. The 
procedure is set up as follows: 

INTEGER PROCEDURE L0G_0PEN(TITLE_PTR) ; 
VALUE TITLE_PTR; 
POINTER TITLE PTR; 



TITLE_PTR points to a period (.) or pointer to a file title. An empty title opens the 
current SUMLOG file. The results are as follows: 



Value 


Meaning 


0 


File already opened 


1 


File successfully opened 


2 


Attribute error on title 


3 


File not a valid log file 


4 


Usercode not allowed 


5 


File not available 



LOG_READ 

The LOG_READ procedure returns the first record of the next visible entry in the log 
file. This procedure is set up as follows: 

BOOLEAN PROCEDURE L0G_READ (BUFFER) ; 
ARRAY BUFFER[0] ; 



The parameter for this procedure is a buffer for the return of the log file record data. 
The procedure returns the read logical result descriptor if the log was opened, or an 
end-of-file (EOF) condition if the log was not opened. 

The LOG_READ procedure is similar to the LOG_GET procedure, except that 
LOG_READ reads only the first record in an entry, whereas LOG_GET reads the entire 
entry. 
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LOG SEEK 

The LOG_SEEK procedure repositions the log file record pointer at the record with the 
specified relative record number. The procedure is set up as follows: 

PROCEDURE L0G_SEEK (RECORD); 
VALUE RECORD; 
INTEGER RECORD; 



Note that, if LOG_SEEK leaves the record pointer positioned in the middle of a 
multirecord log entry, the next read operation automatically skips to the start of the 
next logical log entry. If LOG_READ is used for the next read operation, the first 
record of the next visible log entry is returned. If LOG_GET is used for the next read 
operation, all of the next visible log entry is returned. 

LOGSELECT 

The LOG_SELECT procedure selects access modes for the log file. The procedure is set 
up as follows: 

INTEGER PROCEDURE LOG_SELECT(STYPE,SBUFFER) ; 
VALUE STYPE; 
REAL STYPE; 
ARRAY SBUFFER[0] ; 



In this procedure, STYPE contains the selection case, and SBUFFER contains the 
selection data, which is case dependent. 

The results are case dependent; negative is failure. 

The following functions can be selected: 

STYPE Value Name Function 

0 CLEAR Clears the specification of a timeframe that 

might have been set up by a call to 
LOG_SELECT with STYPE = 1. 

1 TIMEFRAME SET Causes only log entries to be returned that fall 

in the time range specified in the SBUFFER 
parameter. SBUFFERtO] and SBUFFER[1] 
contain the start date and start time, and 
SBUFFER[2] and SBUFFER[3] contain the 
end date and end time. 

If SBUFFERtO] contains a value of 7, the 
dates and times are in SBUFFERtl] and 
SBUFFERE3] in TIME(7) format. Otherwise, 
the dates are in SBUFFERtO] and 
SBUFFER[2] in Julian date format, and the 
times are in SBUFFERtl] and SBUFFER[3] in 
minutes as an integer value. 
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continued 

STYPE Value Name 

2 LOG RANGE GET 



3 USERCODE SET 



4 ACCESS CODE SET 



Function 

Returns the date and time of the first record 
in the log file in SBUFFER[0] and 
SBUFFER[1], and the date and time of the 
last record in the log file in SBUFFER[2] and 
SBUFFER[3]. 

If SBUFFERtO] contains a value of 7, the 
dates and times are returned in SBUFFERtl] 
and SBUFFER[3] in TIME(7) format. 
Otherwise, the dates are returned in 
SBUFFERtO] and SBUFFER[2] in Julian date 
format, and the times are returned in 
SBUFFERtl] and SBUFFER[3] in minutes as 
an integer value. 

This function is available only with InfoGuard 
SDASUPPORT. If the function is not available, 
a -1 error code is returned. 

The SBUFFER parameter contains a 
USERCODE as a standard form name. If the 
SDASUPPORT library functions in filtered 
mode (see FILTERING SET), filtering is 
performed using this USERCODE. If the caller 
does not have direct read access to the 
SUMLOG file to be opened, and the 
USERCODE is not equal to the caller's, an 
open error (4) is returned by LOG OPEN. If 
SBUFFER contains an invalid name, a -2 
error code is returned. If a log file is currently 
open, a -3 error code is returned. 

Three special names are valid: if 
SBUFFER[0].[47: 8] contains 48"00", no 
filtering based on USERCODE is performed. If 
SBUFFER[0].[47:24] contains 48"030000", 
the search target is for entries without an 
associated USERCODE. If 
SBUFFER[0].[47:24] contains 48"030100", 
the search target is the USERCODE of the 
calling process. 

This function is available only with InfoGuard 
SDASUPPORT. If the function is not available, 
a -1 error code is returned. 

The SBUFFER parameter contains an 
accesscode as a standard name. If the 
SDASUPPORT library functions in filtered 
mode (see FILTERING SET), filtering is 
performed using this accesscode. If SBUFFER 
contains an invalid name, a -2 error code is 
returned. If a log file is currently open, a -3 
error code is returned. 

continued 
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STYPE Value Name Function 

Three special names are valid: if 
SBUFFER[0].[47:08] contains 48"00", no 
filtering based on ACCESSCODE is performed. 
If SBUFFER[0].[47:24] contains 
48"030000", the search target is for entries 
without an associated ACCESSCODE. If 
SBUFFER[0].[47:24] contains 48"030100", 
the search target is the ACCESSCODE of the 
calling process. 

5 FILTERING SET This function is available only with InfoGuard 

SDASUPPORT. 

SBUFFER[0] contains one of the following 
values: 

• 0 = No change,- the current setting is 
returned. 

• 1 = Enter a filtering mode in which 
LOG_GET and LOG_READ return only 
those entries that match the USERCODE, 
CHARGECODE, and ACCESSCODE of the 
user process. 

• 2 = Enter a filtering mode similar to that 
specified by a value of 1, except that 
LOG_GET and LOG_READ are also 
allowed access to public entries (such as 
maintenance and halt/load entries). 

• 3 = Exit filtering mode if the caller has 
direct read access to the SUMLOG file; 
otherwise, the filtering value of 2 is used. 

This function can be selected only when no 
log file is open. If a log file is open, a -3 error 
code is returned. 

6 RESULT SET This function is available only with InfoGuard 

SDASUPPORT. If the function is not available, 
a -1 error code is returned. 

SBUFFER[0].[3:4] contains the following 
RESULT value bit mask: 

• Bit [ 3: 1], if set, causes security 
violation entries to be visible. 

• Bit [2: 1], if set, causes security relevant 
entries to be visible. 

• Bit [ 1: 1], if set, causes failure entries to 
be visible. 

• Bit [ 0: 1], if set, causes successful 
entries to be visible. 

The default is all RESULT types are passed. 
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STYPE Value Name Function 

7 CHARGECODE SET This function is available only with InfoGuard 

SDASUPPORT. If the function is not available, 
a -1 error code is returned. 

The SBUFFER parameter contains a 
chargecode as a standard name. If the 
SDASUPPORT library functions in filtered 
mode (see FILTERING SET), filtering is 
performed using this chargecode. If SBUFFER 
contains an invalid name, a -2 error code is 
returned. If a log file is currently open, a -3 
error code is returned. 

Three special names are valid: if SBUFFER 
contains 48"00", no filtering based on 
CHARGECODE is performed; SBUFFER 
contains 48"030000", the search target is for 
entries without an associated CHARGECODE; 
SBUFFER contains 48"030100", the search 
target is the CHARGECODE of the calling 
process. 

The following STYPE values are valid only if the SDASUPPORT library was compiled 
with the compiler option DIAGNOSTICS set: 

STYPE Value Option Description 

1021 NO WARNING Suppresses unwanted or inappropriate 

warnings. Currently the only warning that 
can be suppressed is the warning that the 
Major Type 2, Minor Type 16 (IOP I/O 
Error) entry will be discontinued. 

1022 EXPERIMENTAL OUTPUT Forces diagnostic information to be 
TO PRINTER written to a printer file. 

1023 EXPERIMENTAL SET Causes diagnostic information to be 

generated. If the SDASUPPORT library is 
called by a remote caller, the information 
is written to a remote file, otherwise it is 
written to a printer file. 



LOG_SKIP 

The LOG_SKIP procedure skips a number of records in the log file. The procedure is 
set up as follows: 

BOOLEAN PROCEDURE L0G_SKIP(M0DE) ; 
VALUE MODE; 
INTEGER MODE; 
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To hip 1 O—K 


LUg Cllliy vldiacs luuill../ 


Major 


Minor 


Default Log 


MINIMAL Log 


Type 


Type 


Option Setting 


Option Setting Entry Class 




61 




BNA Version 1 debug entry 




62 




Add X.25 terminal entry 




63 




Modify X.25 terminal entry 




64 




Delete X.25 terminal entry 




65 




Add X.25 application entry 




66 




Modify X.25 application entry 




67 




Delete X.25 application entry 




68 




X.25 MCS phase change entry 




69 




X.25 call established entry 




70 




X.25 call terminated entry 




71 




X.25 call statistics entry 




72 




X.25 endpoint moved entry 




/ O 




a.^o icpon eniry 


13 ' 




S 


S BNA VERSION 2 ENTRY 




0 




General BNA Version 2 log entry 




1 




Local task support activity log 








entry 


14 




S 


S MLS MESSAGE ENTRY 




1 




RSVP message entry 




4 




INFO message entry 




9 




Unit RSVP message entry 




10 




Special RSVP message entry 


15 






VOLUME STATUS ENTRY 




1 




Volume online entry 




2 




Volume offline entry 




3 




Tape volume purged entry 




4 




Tape volume expired entry 


Legend 
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Table 12-5. Log Entry Classes (cont.) 



Major 


Minor 


Default Log 


MINIMAL Log 




Type 


Type 


Option Setting 


Option Setting 


Entry Class 




5 






Tape volume newfile entry 




6 






Directory add entry 




7 






Directory change entry 




8 






Directory delete entry 




9 






Directory destroy entry 




10 






Directory overwrite entry 




11 






Directory purge entry 


16 








FILE STATUS ENTRY 




1 






File creation and copy entry 




2 






File creation entry 




3 






File removal entry 




A 

*T 






nic uuc wi id i i^c ciiuy 




o 






rue security auriDuie eniry 




D 






File copy entry 


1 7 








Un 1 A L.UIVI IVI UUINrHaUKA 1 IUIN 










ENTRY 




1 






Data comm IDC change entry 




2 






New data comm install and copy 










entry 




3 






New data comm install entry 


18 








COMS CONFIGURATION ENTRY 




1 






Agenda change entry 




2 






Program change entry 




o 
o 






i i uuCoon ig-ui*i 1 1 ui iuii^ oiiny 




4 






Processing-item list change entry 




5 






Library change entry 




6 






Database change entry 




7 






Station change entry 
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The converted SUMLOG files can be analyzed by programs that were designed to 
analyze Mark 3.6 SUMLOG files. 

BEGIN 

FILE LOG(DEPENDENTSPECS=TRUE,UPDATEFILE=TRUE); %T0 BE FILE EQUATED 
ARRAY BUFFER[0:29]; 
INTEGER W; 

DEFINE LOGLINKX = 0 #, 

LOGBLOCKF = [47: 8] #, 

LOGTYPEX = 3 #, 

LOGRESULTJISIBILITYF = [31: 4] #, 

LOGMAJORF = [27:12] #; 

READ (LOG, 30, BUFFER); 

IF BUFFER [LOGLINKX], LOGBLOCKF NEQ 1 OR 
BUFFER[LOGTYPEX] . LOGMAJORF NEQ 10 THEN 
BEGIN 

REPLACE POINTER(BUFFER) BY "FILE IS NOT A SUMLOG FILE\0; 
DISPLAY (BUFFER); 
MYSELF. STATUS := -1; 
END; 

WHILE NOT READ (LOG, 30, BUFFER) DO 
BEGIN 

IF BUFFER[LOGLINKX]. LOGBLOCKF EQL 1 THEN 

IF BUFFER [LOGTYPEX] .LOGRESULT_VISIBILITYF NEQ 0 THEN 
BEGIN 

BU FFER [LOGTYPEX] . LOGRESULT_V ISIBILITYF := 0; 
WRITE (LOG, 30, BUFFER); 
W :=* +1; 
END; 

END; 

REPLACE POINTER(BUFFER[0]) BY W FOR * DIGITS," UPDATES PERFORMED" ,0; 

DISPLAY (BUFFER); 

END. 
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Log Entry Types 

A number of major classes of log entries (identified by major type numbers) have been 
established; each major class is divided into subclasses that are identified by minor type 
numbers. The log entry classes are listed in Table 12-5, "Log Entry Classes," and a 
detailed description of the format of each type is presented later in this section. The log 
entry formats in this section are presented in order according to their major and minor 
type numbers. 

The Default Log Option Setting column in Table 12-5 indicates which log entry types 
are logged by default. The LOGGING (Logging Options) system command can be used 
to select the log entry types to be logged. For further information about this feature, 
refer to "Selecting the Entry Types to be Logged" in this section. 

The MINIMAL Log Option Setting column specifies the log setting when the LOGGING 
MINIMAL system command is issued. 

Major Types 8 and 9 were used in previous releases but are no longer used. These 
major types are listed in Table 12-5 to show that major types with these numbers 
formerly existed. However, the formats for log entries with these major types are no 
longer listed in the section. 

Major and Minor Type = 0 are conditions reserved to flag null records. 



Table 12-5. Log Entry Classes 



Major 


Minor 


Default Log 


MINIMAL Log 




Type 


Type 


Option Setting 


Option Setting 


Entry Class 


0 








IDENTIFICATION ENTRY 




1 


S+J 


S+J 


Establish identity entry 


1 








JOB ENTRY 




1 


S+J 


S+J 


Beginning-of-job (BOJ) entry 




2 


S+J 


S+J 


End-of-job (EOJ) entry 




3 


S+J 


S+J 


Beginning-of-task (BOT) entry 




A 
—r 


O . 1 

VJ 1 V 


O i 1 
^ 1 -J 


Eryri r\t fiol/ /C r\T\ artm 
i_i ivj wi -icior\ \ i_ w I y i^i iki y 




5 


s 




File-open entry 




6 


s 




File-close entry 




7 


S+J 


S+J 


Controller-rejected job entry 




8 


J 


J 


Aborted-history entry 




9 






Usercode validation entry 
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Table 12-5. 


Log Entry Classes (cont.) 


Major 


Minor 


Default Log 


MINIMAL Log 


Type 


Type 


Option Setting 


Option Setting Entry Class 




10 


S 


File interval entry 




1 1 


s 


Print request entry 






s 


Print request complete entry 




13 




Start printing file entry 




1 A 

14 




Finish printing file entry 




15 




Library link entry 




16 




Library delink entry 




17 




Library freeze entry 




18 




Library resume entry 




19 




Database open entry 




20 




Database close entry 




21 




Database freeze entry 




22 




Database resume entry 




25 


s 


File statistics record entry 


2 




s 


S MAINTENANCE ENTRY 




11 




Library maintenance error entry 




12 




Mainframe error entry 




14 




Disk file optimizer error entry 




16 




I/O error entry (EMS/HDU/RMM) 




17 




Hardware configuration entry 




18 




Software configuration entry 




19 




Environment configuration entry 








(Extended memory systems only) 




20 




Internal processor errors entry 








(Al, A 2, A3, A 4, A 5, A 9, 








A 10 only) 




21 




I/O exception entry 








(MLIOEXCEPTION) 


Legend 
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Table 12-5. Log Entry Classes (cont.) 



Major 


Minor 


Default Log 


MINIMAL Log 




Type 


Type 


Option Setting 


Option Setting 


Entry Class 




22 






Unit I/O counts entry 




23 






Mainframe hardware report entry 


3 




J 


J 


STRING ENTRY 




1 






RSVP message entry 




2 






FATAL error message entry 




3 






NONFATAL error message entry 




4 






SYSTEM message entry 




5 






UNIT error message entry 




6 






DIRECTORY error message entry 




7 






DISPLAY message entry 




8 






STATUS message entry 




9 






UNIT RSVP message entry 


4 








MCS ENTRY 




1 


S+J 


S+J 


Session log-on entry 




2 


S+J 


S+J 


Session log-off entry 




3 


S+J 




RJE control card entry 




4 


S+J 


J 


MCS message entry 




5 


S+J 


J 


MCS time accrued entry 




6 


s 


S+J 


MCS security violation entry 




7 


s 




MCS station application entry 




8 






Remote window open/close entry 




9 






MCS window open/close entry 




10 


s 




Direct window open/close entry 




11 






MCS command entry 


5 




s 


s 


NSP MAINTENANCE ENTRY 




1 






NSP initialization entry 




2 






MCS initialization entry 
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Table 12-5. Log Entry Classes (cont.) 



Major 
Type 


Minor 
Type 


Default Log MINIMAL Log 
Option Setting Option Setting 


Entry Class 




4 




MCS result message entry 




6 




UIO-DC unsuccessful I/O entry 




7 




UIO-DC abnormal termination 
entry 


\j 






MRPFI 1 ANFDI 1^ FNTRY 




1 


S+J S 


Halt/load entry 




2 


S+J S+J 


Log release entry 




3 


S+J S+J 


SETSTATUS entry 




4 


S S 


Security violation entry 




5 


S J 


Deimplementation warning entry 




6 


s 


Power off entry 




7 


s 


Controller command entry 




8 


s 


Print subsystem command entry 




9 


s 


USERDATA change entry 




10 




New USERDATA install and copy 
entry 




11 


s 


New USERDATA install entrv 




12 


s 


Primitiv/p command pntrv 

1 IIIIIIIIVO UUI 1 1 1 1 1C4 1 IU t^lllljr 




13 




IHIp w^tpm timpr pntrv 




14 




Halt load reason entry 




15 


s 


Disk resource control errors entry 




1 

ID 


c 
o 


occuniy-reicvani warning entry 


7 




S+J S+J 


INSTALLATION ENTRY 


8 






(Not currently used) 


9 






(Not currently used) 


10 


1 

2 


s s 


DATE/TIME RESET 
Log created by A 2 entry 
Log created by A 6 entry 


Legend 
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Table 12-5. 


Log Entry Classes (cont.) 


Major 


Minor 


Default Log 


MINIMAL Log 


Type 


Type 


Option Setting 


Option Setting Entry Class 




5 




Log created by A 3 entry 




6 




Log created by A 9 entry 




7 




Log created by A 1 5 entry 




9 




Log created by A 10 entry 




10 




Log created by A 5 entry 




15 




Log created by A 12 entry 




16 




Log created by A 1 entry 




17 




Log created by A 17 entry 




19 




Log created by A 4 entry 




20 




1 rax rrf*at(*c\ hv Mirrn A pntrv 


11 




S 


S BNA Version 1 ENTRY 




1 




Set network services manager 








(NSM) attribute entry 








Set port level manager (PLM) 








attribute entry 




6 




Set router attribute entry 




4 




Set station level manager (SLM) 








attribute entry 




5 




Network services manager (NSM) 








phase change entry 




6 




Add host entry 




7 




Add node entry 




8 




Host status entry 




9 




Delete host entry 




IU 




Delete node entry 




11 




Port level manager (PLM) error 








entry 




12 




Port level manager (PLM) log 








entry 


Legend 
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Table 12-5. Log Entry Classes (cont.) 



Major 
Type 


Minor 
Type 


Default Log 
Option Setting 


MINIMAL Log 
Option Setting 


Entry Class 




13 






Resistance factor change entry 




14 






Qtart trarp pntrv 










rvuuuiig iciicbii ciuiy 




16 






Router control frame sent entry 




17 






Router control frame received 
entry 




18 






Rnntpr framp prrnr pntrv 




1 9 






L/COIM ICIIIUI l 1 IUUC oldluo Ollall^C 

entry 




20 






Router monitor frame copy entry 




21 






Router monitor traffic summary 
entry 




22 






Add profile entry 




23 






Delete profile entry 




24 






Router node existence entry 




25 






Modify station entry 




26 






Delete station entry 




27 






Add ensemble entry 




28 






Modify ensemble entry 




29 






Delete ensemble entry 




30 






Add connection entry 




31 






Modify connection entry 




32 






Delete connection entry 




33 






Clear call-entry 




34 






Establish call entry 




35 






Await call entry 




36 






Send test entry 




37 






Test received entry 
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Table 12-5. Log Entry Classes (cont.) 



Major 
Type 


Minor 
Type 


Default L off 

Option Setting 


MINIMAL Loe 
Option Setting 


Entry Class 




38 






Test response received entry 




39 






Link reset entry (Not currently 
used) 




40 






Open connection port entry 




41 






Close connection port entry 




42 






Station attach entry 




43 






Station detach entry 




44 






Save station entry 




45 






Ready station entry 




46 






Open station dialog entry 




47 






Close station dialog entry 




48 






Station attach entry 




49 






Station detach entry 




50 






Neighbor restart entry (Not 
currently used) 




51 






Neighbor remote busy entry (Not 
currently used) 




52 






Station log report entry 




53 






Station validation failure entrv 

wiuiiwi i veil iuci uvsi i laiiuiw winijr 




54 






Station monitor entry 




55 






Add station entry 




56 






Operator message entry 




57 






Operator initiated assign entry 
(Not currently used) 




58 






SCM return entry (Not currently 
used) 




59 






Target initiated assign entry (Not 
currently used) 




60 






SCM frame received entry (Not 
currently used) 
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Log entry Classes ^conw 


Major 


Minor 


Default Log 


MINIMAL Log 


Type 


Type 


Option Setting 


Option Setting Entry Class 




61 




BNA Version 1 debug entry 




62 




Add X.25 terminal entry 




63 




Modify X.25 terminal entry 




64 




Delete X.25 terminal entry 




65 




Add X.25 application entry 




66 




Modify X.25 application entry 




67 




Delete X.25 application entry 




68 




X.25 MCS phase change entry 




69 




X.25 call established entry 




70 




X.25 call terminated entry 




71 




X.25 call statistics entry 




72 




X.25 endpoint moved entry 




73 




X.25 report entry 


12 




S 


VSID ENTRY 




1 




Subsystem initiation entry 




2 




Subsystem termination entry 




3 




Unit online entry 




4 




Unit offline entry 




5 




Unit ready entry 




6 




Unit not-ready entry 




7 




Unit in-use entry 




8 




Unit not-in-use entry 




9 




Begin printing a copy entry 




10 




End of printing a copy entry 




11 




Special log information entry 




12 




Peripheral interface error entry 


13 




S 


S BNA VERSION 2 ENTRY 


Legend 
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Table 12-5. Log Entry Classes (cont.) 



1 Via J Of 


IVIIIIUI 




MINIMAI 1 op 

IVII fill VIM L l-Ug 




Type 


Type 


Option Setting 


Option Setting 


Entry Class 




0 






General BNA Version 2 log entry 




1 






Local task support activity log 










entry 


14 




S 


S 


MLS MESSAGE ENTRY 




1 






RSVP message entry 




4 






INFO message entry 




9 






Unit RSVP message entry 




10 






Special RSVP message entry 


15 








VOLUME STATUS ENTRY 




1 






Volume online entry 




2 






Volume offline entry 




3 






Tape volume purged entry 




4 






Tape volume expired entry 




5 






Tape volume newfile entry 




6 






Directory add entry 




7 






Directory change entry 




8 






Directory delete entry 




9 






Directory destroy entry 




10 






Directory overwrite entry 




11 






Directory purge entry 


16 








FILE STATUS ENTRY 




1 






File creation and copy entry 




2 






File creation entry 




3 






File removal entry 




4 






File title change entry 




5 






File security attribute entry 




6 






File copy entry 
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Table 12-5. Log Entry Classes (cont.) 



Major 


Minor 


Default Log 


MINIMAL Log 




Type 


Type 


Option Setting 


Option Setting 


Entry Class 




8 






Station list change entry 




9 






Window change entry 




10 






Window list change entry 




1 1 






Usercode change entry 




12 






Load file and copy entry 




13 






Load file entry 


19 








DIAGNOSTICS ENTRY 




1 






Distributed systems services 










(DSSs) entry 




4 






Message Handling System (MHS) 










entry 




5 






Open Systems Interconnection 










(OSI) entry 




6 






TCP/IP (TCP IP) entry 




7 






Network-independent software 










(NIS) entry 




11 






Host LAN Connection (HLCN) 










entry 










OSI Directory (DIR) entry 




13 






Network Management System 










(NMS) entry 




16 






Systems Network Architecture 










(SNA) entry 


25 




S 


S 


HOST LAN CONNECTION ENTRY 




1 






Change network processor entry . 




2 






Network processor report entry 




3 






Add NETACCESSPOI NT entry 




4 






Change NETACCESSPOI NT entry 




5 






Delete NETACCESSPOI NT entry 
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Table 12-5. Log Entry Classes (cont.) 



Major 


Minor 


ueiauit Log 


Ml Ml MAI 1 na 
IVIIINIIVIAL LOg 




Type 


Type 


Option Setting 


Option Setting 


Entry Class 




c 
O 






rcesei rouier eniry 




7 






Network manager report entry 


27 








TCP/IP ENTRY 




1 






Transmission Control Protocol 










(TCP) layer entry 




2 






Internet Protocol (IP) entry 




Q 

o 
















(ARP) function entry 




A 






Rnntp Information Prntnpnl fPIP^ 
i\uu lc 1 1 iiui 1 1 ictiiui i r i uiuirvji v r\ i r / 










function entry 




5 






User Datagram Protocol (UDP) 










layer entry 




6 






Internet Control Message Protocol 










(ICMP) function entry 




7 






TCP Manager (TCPMGR) function 










entry 




8 






Connect open and close reports 










(PIM) entry 




9 






Reserved 




10 






Entries generated during the 










r-\ yr\r^c\c-c /if on OMh^D /common/"! 

process ot an oiNivir cornrnanu. 




1 1 

1 1 






iviioCciidiicuuo \\j i nervy entry 


28 








NETWORK MANAGEMENT 










ENTRY 




1 






Local Control Facility (LCF) entry 




2 






Network Control Facility (NCF) 










j 




3 






SNMP agent (SNMP) entry 




4 






Miscellaneous (OTHER) entry 



Legend continued 
S SUMLOG all 
J Job log all 
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Table 12-5. Log Entry Classes (cont.) 



Major 


Minor 


Default Log 


MINIMAL Log 






Tvnp 


Ontion Spttinp 


Ontion Setting 

wpiiun veiling 


Fntrv Cla<t< 

LI Illy w[<]99 


30 








SYSTEMS NETWORK 










ARCHITECTURE (SNA) ENTRY 




1 






Noteworthy network event 










(REPORT) entry 




2 






Network frame reported as a 










result of the TRACE + command 




3 






Unexpected fault condition 










(ERROR) entry 




4 






Solicited status request and 










response (INQUIRY) entry 




5 






Solicited action request and 










response (COMMAND) entry 




6 






Miscellaneous (OTHER) entry 



Legend 

S SUMLOG all 
J Job log all 
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Major Type = 0 Establish Identity Entry (LOGMAJJDENTYTIV) 

Major Type °> Minor Type 1 (Establish Identity) entries describe the identity associated 
with a mix number, when it is not otherwise contained in the SUMLOG or the identity 
is changed. An identity is made from a usercode, access code, and origination. Typically, 
these appear in the SUMLOG right after a Transfer Log (TL) has been performed. 



Table 12-6. Major Type O-Minor Type 1 



Minor Type = 


1 Establish Identity (LOGMIN ESTAB IDV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Privilege status 




[9:1] Security administrator 




[ 0: 1] Privileged user 


o 


T\/np 




LiD: ij ml-o cession 




[14:15] Process type (if not MCS session) 




0 = Dependent task (PROCESS) 




1 = Coroutine (CALL) 




2 = Independent task (RUN) 




3 = Job Stack 


6 


LINK to external or station name 


7 


LINK to usercode 


8 


LINK to charge code 


9 


LINK to session attribute PPB 


10 


Source information 




[23: 8] MCS number (if MCS Session) 




[15: 1] MCS Session 




[14:15] LSN number (if MCS Session) 
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Table 12-6. Major Type O-Minor Type 1 (cont) 



iviinoi iypc — 


1 Pctahlieh IHontitv (\ ncMIKI PQTAR \n\l\ 

i tsiauiisn lucnuiy iluuiviiin coiad iuv) 


woras 


Description 


1 1 
1 1 


LINK to access code 


12 


Time started (timestamp) 


13 


LINK to MCS name 


14 


Stack number 




[47:32] = This field is not used 




[15:16] = Stack number 


15-end 


Variable-length data pointed to by the LINKs in this entry 


Table 12-7. Major Type O-Minor Type 2 


Minor Type = 


1 Change Identify (LOGMIN_CHANGE_IDV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Mix number information 




[19:20] New mix number 




[39:20] Old mix number 
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Major Type = 1 Job or Task Entry (LOGMAJJOB) 



Table 12-8. Major Type 1-Minor Types 1 and 3 



Minor Type = 1 BOJ Entry (LOGBOJTYP) 
Minor Type = 3 BOT Entry (LOGBOTYP) 



Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

4 Task priority information 
[47:24] Job queue 
[23:24] Priority 

5 Task type 



[47: 1] Job restarted, either manually or automatically after a halt/load 

[46: 1] Task fired off by DMS access routines; typically, by a DMS ABORT 
routine. 

[45: 1] MCS fired off by Datacom Controller stack 
[44: 1] Task contains unsafe code 
[43: 1] Task is subject of TADS session 

[41: 1] Privileged program, if the result indicator field of Word 3 has a 
value of 2 (security relevant) 

[39: 1] Program marked with security administrator privilege 

[38: 1] Program marked with tasking status by the MP (Mark Program) 
system command 

[37: 1] Job manually restarted (bit [47: 1] is also set) 
[15:16] Process type 

0 = Dependent task (PROCESS) 

1 = Coroutine (CALL) 

2 = Independent task (RUN) 

3 = Job stack 

6 LINK to external name 

continued 
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Table 12-8. Major Type 1-Minor Types 1 and 3 (cont.) 



Minor Type = 
Minor Type = 


1 BOJ Entry (LOGBOJTYP) 
3 BOT Entry (LOGBOTYP) 


Words 


Description 


7 


LINK to usercode 


8 


LINK to charge code 


9 


LINK to compiled name. Contains name of object code file if task was 
COMPILE or BIND; otherwise, value is zero 


10 


Task source and destination information 

[45: 6] Destination MCS 

toy: lj Destination is RtMOlt 

[38:15] Destination UNIT 

[21: 6] Originating MCS 

[15: 1] Origin is REMOTE 

[14:15] Originating UNIT 

If [15: 1] (above) is SET, the [14:15] field contains a logical station 
number (LSN). If [15: 1] is RESET, word 19 of this entry contains the 
device number of the originating unit. 


11 


LINK to access code 


12 


Joh pntrv timp 

[47:16] Contains the date 

[31:32] Holds the entry time 

The job entry time is the timestamp of the code file. Thus, for a job, it is 
the time the WFL compiler finished with it and it entered the system. For a 
task, it is the timestamp of the object code file being run. It is zero if the 
code stack was being shared with an already running task. The date format 
is [47:16] (Julian date - 70000). The entry time format is [31:32] (time 
of day in ticks DIV 16). 


13 


Compiler information 

[47: 1] Interprocess communication (IPC) capable 
[46: 1] Sort capable 



continued 
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Table 12-8. Major Type 1-Minor Types 1 and 3 (cont.) 



Minor Tvdp = 


1 BOJ Entrv fLOGBOJTYP) 




Minor Type = 


3 BOT Entry (LOGBOTYP) 




i Words 


Description 






[45: 1] Control program 






[44: 1] DMS capable 






[43: 1] No uplevel pointers 






[42: 1] Privileged program 






[41: 1] Library capable 






[40: 1] WFL: No global file equation 






[39: 1] Privileged transparent program 






[38: 1] Suppressed 






[37: 1] Resident program 






[31: 8] Language type 






0 = ALGOL 






1 = COBOL 






2 = FORTRAN 






4 = PL/1 






5 = JOVIAL 






6 = NEWP 






7 = ESPOL 






8 = DCALGOL 






9 = BASIC 






10 = WFL 






14 = PASCAL 






15 = RPG 






16 = FORTRAN77 






17 = COBOL74 






18 = SORT 






254 = INTRINSICS ($INTRINSICS set) 
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Table 12-8. Major Type 1-Minor Types 1 and 3 (cont.) 



Minor Type 
Minor Type 


= 1 BOJ Entry (LOGBOJTYP) 
= 3 BOT Entry (LOGBOTYP) 


Words 


Description 








[23: 8] Compiler mark number and level number 




[15: 1] Program has tasking privilege. 




[14: 1] Program has security administrator privilege. 




[13: 1] Program has security administrator transparent privilege. 




[12: 1] Program has tasking transparent privilege. 




[ 9:10] Compiler cycle number 


14 


Prior to the Mark 3.9 system software release, this word contained the 
following SWAPPER information: 

[39:10] Number of swap space core slots in use 

[15: 8] SUBSPACE attribute requested 

0 = Do not run in swap space 

1 = Data (D2) stack only in swap space 

2 = Data in swap space. Code (Dl) stack in swap space if code file is 
in my directory. 

3 = Data and code in swap space 

[ 7: 8] SUBSPACE actually granted (Same as [15: 8], but 2 is not valid.) 


15 


Prior to the Mark 3.9 system software release, this word contained the 
numbers of ASNs used by the process. 

[39:20] ASN of code (Dl) stack 
[19:20] ASN of data (D2) stack 


16 


Prior to the Mark 3.9 system software release, this word contained a LINK 
to the value of the SUBSYSTEM task attribute. 


17 


LINK to the value of the ITINERARY chain. The LENGTH field is in 
characters rather than words. 


continued 
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Table 12-8. Major Type 1-Minor Types 1 and 3 (cont.) 



Minor Type = 


1 BOJ Entry (LOGBOJTYP) 


Minor Type = 


3 BOT Entry (LOGBOTYP) 


Words 


Description 


18 


Amount of time spent in the schedule 


19 


Contains the external device number of the originating unit (if not a remote 




station; see Word 10, field [14:15] of this entry). 


20-21 


(Reserved for future use) 


22 


LINK to the value of the SOURCENAME task attribute 


23 


LINK to the value of the MCSNAME task attribute 


24 


Stack number 




[47:32] = This field is not used 




[15:16] = Stack number 


25-end 


Variable-length data pointed to by the LINKs in this entry. 


Table 12-9. Major Type 1-Minor Types 2 and 4 


Minor Type = 


2 EOJ Entry (LOGEOJ) 


Minor Type = 


4 EOT Entry (LOGEOTYP) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Task priority information 




[47:24] Job queue 




[23:24] Priority 


5 


Task type 




[47: 1] Job restarted 




[46: 1] Task fired off by DMS access routines; typically, by a DMS ABORT 




routine 
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Table 12-9. Major Type 1-Minor Types 2 and 4 (cont.) 



Minor Type 
Minor Type 


= 2 EOJ Entry (LOGEOJ) 
= 4 EOT Entry (LOGEOTYP) 


Words 


Description 




[45: 1] MCS fired off by Datacom Controller stack 




[15:16] Process type 




0 = Dependent task (PROCESS) 




1 = Coroutine (CALL) 




2 = Independent task (RUN) 




3 = Job stack 


6 


LINK to external name 


7 


LINK to usercode 


8 


LINK to charge code 


9 


LINK to compiled name. Contains name of object code file if task was 
COMPILE or BIND, otherwise value is zero. 


10 


Task source and destination information 

[45: 6] Destination MCS 

[39: 1] Destination is REMOTE 

[38:15] Destination UNIT 

[21: 6] Originating MCS 

[15: 1] Origin is REMOTE 

[14:15] Originating UNIT 

If [15: 1] (above) is SET, the [14:15] field of this word contains a logical 
station number (LSN). If [15: 1] is RESET, Word 35 of this entry contains 
the device number of the originating unit. 


11 


Processor timet 




i is\ l: x 

l/KJ IIIIICI 


13 


Number of lines printed! 


14 


Number of cards readt 



t Includes resource usage of any offspring using anonymous task accounting continued 
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Table 12-9. Major Type 1-Minor Types 2 and 4 (cont.) 



Minor Type 
Minor Type 


= 2 EOJ Entry (LOGEOJ) 
= 4 EOT Entry (LOGEOTYP) 


Words 


Description 


15 


Number of cards punchedt 


16 


Memory integral code, Dl stack 


17 


Memory integral data, D2 stack 


18 


Termination condition. Contains the value of the HISTORY task attribute at 
the time of termination. For a description of the format of this word, refer to 
the A Series Task Attributes Programming Reference Manual. 


19 


Prior to the Mark 3.9 system software release, this word contained the 
following SWAPPER information 

[39:10] Number of swap space core slots in use 

[15: 8] SUBSPACE attribute requested 

0 = Do not run in swap space. 

1 = Data (D2) stack only in swap space. 

2 = Data in swap space. Code (Dl) stack in swap space if code file is 
in my directory. 

3 = Data and code in swap space. 

[ 7: 8] SUBSPACE actually granted (Same as [15: 8], but 2 is not valid.) 


21 


Average code space 


22 


Average data space 


23 


FIpih^pH timp 

Ltapocu in i ic 


24 


LINK to access code 


25 


Compiler information 
[47: 1] IPC capable 
[46: 1] Sort capable 
[45: 1] Control program 
[44: 1]DMS capable 



t Includes resource usage of any offspring using anonymous task accounting continued 
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Table 12-9. Major Type 1-Minor Types 2 and 4 (cont.) 



Minor Type 

Minnr Tvnp 


= 2 EOJ Entry (LOGEOJ) 

— 4 POT Fntrv (\ OGFOTYP1 


Words 


Description 




[43: 1] No uplevel pointers 




[42: 1] Privileged program 




[41: 1] Library capable 




[40: 1] WFL: No global file equation 




[39: 1] Privileged transparent 




[38: 1] Suppressed 




Lo/. 1J ncolUclll (JlUgldlll 




[31: 8] Language type 




0 = ALGOL 




1 = COBOL 




2 = FORTRAN 




4 = PL/1 




5 = JOVIAL 




6 = NEWP 




7 = ESPOL 




8 = DCALGOL 




9 = BASIC 




10 = WrL 




1 *t — rnoi/nL 




15 = RPG 




16 = FORTRAN77 




17 = COBOL74 




18 = SORT 




254 = INTRINSICS ($INTRINSICS set) 




255 = MCP ($MCPset) 




[23: 8] Compiler mark number and level number 



t Includes resource usage of any offspring using anonymous task accounting continued 
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Table 12-9. Major Type 1-Minor Types 2 and 4 (cont.) 



Minor Type = 
Minor Type = 


2 EOJ Entry (LOGEOJ) 
4 EOT Entry (LOGEOTYP) 


Words 


Description 




[ 9:10] Compiler cycle number 


26 


Prior to the Mark 3.9 system software release, this word contained the core 
allocated and occupied. ASN 1 is valid if bit 1 in the appropriate field is set. 

[31: 8] Data core allowed (= Word 36) 

[23: 8] Code core allowed (= Word 37) 

[15: 8] Data core occupied (= Word 38) 

[7:8] Code core occupied (= Word 39) 

Note: For extended memory systems containing more than 
seven local ASNs, the values of Words 36 through 39 
should be used. 


27 


LINK to the value of the SUBSYSTEM attribute 


28 


LINK to the value of the ITINERARY chain 

The LENGTH field is in characters rather than words. 


29 


Amount of time spent in the ready queue 


30 


Amount of processor time spent handling initial P-bits for this taskt 


31 


Number of initial P-bits for this taskt 


32 


Amount of processor time spent handling all other P-bits for this taskt 


33 


Number of other P-bits for this taskt 


34 


Time at which the task was initiated 
[47:16] Date (Julian date - 70000) 
[31:32] Entry time (time of day in ticks DIV 16) 


35 


Contains the external device number of the originating unit (if not a remote 
station; see word 10, field [14:15] of this entry). 


36 


Data core allocated 


37 


Code core allocated 



t Includes resource usage of any offspring using anonymous task accounting continued 
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Table 12-9. Major Type 1-Minor Types 2 and 4 (cont.) 



Minor Type 
Minor Type 


= 2 EOJ Entry (LOGEOJ) 
= 4 EOT Entry (LOGEOTYP) 


Words 


Description 


38 


Core occupied 


39 


Code core occupied 


40 


Maximum number of ASDs used at any one time by the job/task. In logs 
generated prior to the Mark 3.9 release on ASN systems, this word is zero. 


41 


Integer count of tape volume assignments logged for the process.t This 
woro contains ine numuer ot tape-rue open operations ^except tnose inai 
follow a close operation with the RETAIN option), reel switches, and 
references to tape volumes in library maintenance COPY and ADD 
statements. All printer backup tape file opens are included in this count. 


AO 


Integer count of requests for offline disk volumes that the operator readied 
or otherwise handled so that the job could proceed. t 




Real numoer inai measures ine amount ot temporary qisk space ine iasK or 
job used.t The number logged is the product of the average number of disk 
segments used for temporary disk storage times the number of seconds the 
task or job ran (elapsed time). 


44 


Real number that measures the amount of permanent disk space the task 
or job used.t The number logged is the product of the average number of 
disk segments occupied by permanent disk files that the task had open 
times the number of seconds the job or task ran (elapsed time). 


45 


Maximum save memory used at any one time by the job/task. In logs 
generated prior to the Mark 3.9 release on ASN systems, this word is zero. 


46 


Stack number 

[47:32] = This field is not used 
[15:16] = Stack number 


47 


Variable-length data pointed to by the LINKs in this entry. 



t Includes resource usage of any offspring using anonymous task accounting 



If anonymous task accounting is in effect for a task, no EOT log entry is logged for 
that task. Certain resource usage statistics of the task are added to the resource 
usage statistics of the parent. These statistics are reflected in words 11 through 15, 
30 through 33, and 41 through 44 of the parent EOJ or EOT log entry. For further 
information about anonymous task accounting, refer to "Using Anonymous Task and 
File Accounting" earlier in this section. 
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Table 12-10. Major Type 1-Minor Type 5 



Minor Type = 5 File Open Entry (LOGOPENTYPE) 



Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

4 File size in units of words (valid for disk and pack only) 

5 LINK to internal name 

6 LINK to external name 

7 Open description word 

[47: 2] File Access Rule used 

1 = Actor rights 

2 = Declarer rights 

3 = Union of Actor and Declarer rights 



[45: 1] Value of DUMMYFILE attribute 
[44: 1] An unused field 

[43: 4] The high-order four bits of the open error message number. The 
low-order bits are stored in field [15: 8]. 

The open error message number identifies the system message that explains 
the open error. When an open error occurs, the system issues a Major 
Type 14, Minor Type 4 (INFO Message) log entry that contains the text of 
this system message. When such a log entry is printed by LOGANALYZER or 
appears in a job summary, the message text is preceded by the string 
MSRFIB and the open error message number. For example, open error 
message number 74 refers to system message MSRFIB74, "NOT CLOSED". 

For processes discontinued by open errors, the open error message number 
also corresponds to the HISTORYREASON task attribute value. If the 
HISTORYTYPE value is 4 (DSEDV) and the HISTORYCAUSE value is 8 
(SOFTIOERRCAUSEV), then the open error message number equals the 
HISTORYREASON value. If the HISTORYTYPE value is 4 (DSEDV) and the 
HISTORYCAUSE value is 14 (SOFTIOERR2CAUSEV), then the open error 
message is equal to the HISTORYREASON value plus 256. For descriptions 
of the HISTORYTYPE, HISTORYCAUSE, and HISTORYREASON task 
attributes, refer to the A Series Task Attributes Programming 
Reference Manual. 

[31: 8] Logical type (See Table 12-22, "Peripheral Logical Types.") 
[23: 8] Value of the FILEKIND file attribute 
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Table 12-10. Major Type 1-Minor Type 5 (cont.) 



Minor Type = 


5 File Open Entry (LOGOPENTYPE) 


Words 


Description 




[15: 8] The low-order eight bits of the open error message number. For 




further information, refer to the description of Field [43: 4]. 




[7:7] Value of the MYUSE file attribute: 




1 = INPUT 




2 = OUTPUT 




3 = I/O 




[0: 1] If this bit is 1, then [15: 8] contains an error code. 


8 


LINK to access code 


9 


OPEN parameters 




[46: 1] 1 if file is a valid subfile 




[41:10] Subfile index, if file is a valid subfile 




[15: 4] Motion 




1 = Positioning requested 




2 = No positioning requested 




[11: 4] Position 




1 = AT FRONT 




2 = AT END 




[7:8] Open type 




For nonport files: 




1 = OPEN WAIT 




2 = AVAILABLE 




3 = OFFER 




4 = RESIDENT 




5 = PRESENT 




6 = PBT REEL SWITCH OPEN 




7 = STACK ASSIGNED OPEN REVERSE 




For port files: 



continued 
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Table 12-10. Major Type 1-Minor Type 5 (cont.) 



Minor Type = 5 File Open Entry (LOGOPENTYPE) 



Words Description 



1 = WAIT 

2 = AVAILABLE 

3 = RETURN (OFFER) 

4 = DONTWAIT 

10 Device number 

1 1 Stack using the file (actor) 
[47:12] Stack number 
[31:16] Job number 
[15:16] Task number 

12 Stack owning the file (declarer; same word format as Word 11) 

13 LINK to port file information. This LINK is 0 if this entry is not for a port file. 
If the LINK is nonzero, it points to an area used to contain a block of 
additional information for port files. The information contained in that block 
is listed in the following subtable. The location of each item is described by 
an offset from the start of this block of information. 

The LINKs within this block of information point to strings of characters. The 
length of each string is given in characters (not words) in the length field 
[39:20] of the LINK. The index field [19:20] of the LINK provides the word 
index in the log entry where the information starts. 

Offset Contents 

0 LINK to YOU RHOSTNAME value 

1 LINK to YOURNAME value 

2 Value of MAXSEGSIZE attribute 

3 LINK to YOURUSERCODE value 

4 Value of MYPORTADDRESS attribute 

5 Value of MYSUBPORTADDRESS attribute 

6 LINK to SERVICE value 

7 LINK to PROVIDERGROUP value 

8 LINK to the name of the provider selected, if the OPEN 
succeeded; otherwise, 0 (zero) 

continued 
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Table 12-10. Major Type 1-Minor Type 5 (cont.) 



Minor Type = 


5 File Open Entry (LOGOPENTYPE) 


Words 


Description 






9 


CONNECTTIMELIMIT value, if one was specified; 
otherwise, 0 (zero) 




10 


Initiation primitive invoked 

0 = OPEN 

1 = AWAITOPEN 




11 


RESPOND invocation 

1 = RESPOND(ACCEPTCLOSE) 

2 = RESPOND(REJECTCLOSE) 
31 = RESPOND was not invoked 




18 


ASSOCIATED DATA transmission 

0 = ASSOCIATED DATA was sent 

1 = ASSOCIATED DATA was not sent 




19 


ASSOCIATED DATA receipt 

0 = ASSOCIATED DATA was received 

1 = ASSOCIATED DATA was not received 


14 


LINK to family name in substandard form. 


15-end 


Variable-length data pointed to by the LINKs in this entry. 



See Tables 12-22 through 12-25 for information on peripheral types. 
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Table 12-11. Major Type 1-Minor Type 6 



Minor Type = 6 File Close Entry (LOGCLOSETYPE) 



Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

4 File size in units of words (valid for disk and pack only) 

5 LINK to internal name (standard form) 

6 LINK to external name (standard form) 

7 Close description word 



[47: 2] File Access Rule used 

1 = Actor rights 

2 = Declarer rights 

3 = Union of actor and declarer rights 
[45: 1] Value of DUMMYFILE file attribute 

[43: 4] The high-order four bits of the close error message number. The 
low-order bits are stored in field [15: 8]. 

The close error message number identifies the system message that explains 
the close error. When a close error occurs, the system issues a Major 
Type 14, Minor Type 4 (INFO Message) log entry that contains the text of 
this system message. When such a log entry is printed by LOG ANALYZER or 
appears in a job summary, the message text is preceded by the string 
MSRFIB and the close error message number. For example, close error 
message number 19 refers to system message MSRFIB19, "FAILED 
ENTER". 

For processes discontinued by close errors, the close error message number 
also corresponds to the HISTORYREASON task attribute value. If the 
HISTORYTYPE value is 4 (DSEDV) and the HISTORYCAUSE value is 8 
(SOFTIOERRCAUSEV), then the close error message number equals the 
HISTORYREASON value. If the HISTORYTYPE value is 4 (DSEDV) and the 
HISTORYCAUSE value is 14 (SOFTIOERR2CAUSEV), then the close error 
message is equal to the HISTORYREASON value plus 256. For descriptions 
of the HISTORYTYPE, HISTORYCAUSE, and HISTORYREASON task 
attributes, refer to the A Series Task Attributes Programming 
Reference Manual. 

[31: 8] Logical type (See Table 12-22, "Peripheral Logical Types.") 
[23: 8] Value of FILEKIND file attribute 
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Table 12-11. Major Type 1-Minor Type 6 (cont.) 



Minor Type 


= 6 File Close Entry (LOGCLOSETYPE) 


words 


Description 




[15: 8] The low-order eight bits of the close error message number. For 




further information, refer to the description of Field [43: 4]. 




[7:7] Value of MYUSE file attribute 




1 = INPUT 




9 _ HI ITPI IT 
£ — \JU 1 rU 1 




3 = I/O 




[0: 1] If this bit is a 1, then field [15: 8] contains an error code. 


8 


Name qualification information 




L4^:ioj ucsAoi generation numDer 




[27:11] SAVEFACTOR 




[16:17] Creation date in binary Julian format 


9 


File blocking information 




[47:16] BLOCKSIZE 




[27:11] MINRECSIZE 




[15:16] MAXRECSIZE 


10 


Transaction count (number of logical I/O operations) 


11 


Erapsed I/O time 


1 9 


IVIIbUclldllcUUb IIIIUI IlldllUII 




For a disk file 




[47: 1] Installation-allocated disk (IAD) file 




[46: 1] Permanent file 




[44: 1] Updated file 




[43: 1] CLOSE with CRUNCH 




[42: 1] Protected file 




[40: 1] Interchange disk pack file 
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Table 12-1 1. Major Type 1-Minor Type 6 (cont.) 



Minor Type = 


6 File Close Entry (LOGCLOSETYPE) 


Words 


Description 




[32: 1] Duplicated file 




[31: 4] Number of duplicate copies 




[23:24] Value of AREASIZE attribute 




ror a tape me 




[15: 1] Contains 1 if the file was a multireel file 




[14:15] Reel number 




For units other than tape or disk, this word contains zeros 


13 


Serial number (six EBCDIC characters) for tape file. This word is 0 for other 




units. 


14 


Unit information 




[47:16] INTMODE 




[25:14] CYCLE 




[11: 8] VERSION 




[ 0: 1] UNITS 


15 


Close parameters 




T46- 11 Valid subfile 




r^Q»1fil ^nKfilp inripy if filp ic n \jn\iri Qiihfilp 

L03.1UJ OUUIIIC IIIUCA, II llic lo a VallU OUUIIIC 




[23: 8] Disposition 




l = REWIND 




Z = INUKtWIND 




3 = SAVE 




4 = LOCK 




5 = PURGE 




6 = CRUNCH 




7 = HERE 




8 = BLOCKEXIT 




[15: 8] Association 
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Table 12-11. Major Type 1-Minor Type 6 (cont.) 



Minor Type 


= 6 File Close Entry (LOGCLOSETYPE) 


Words 


Description 




1 = RELEASE 




2 = RETAIN 




3 = RESERVE 




4 = DISABLE 




[7:8] Close type 




For nonport files: 




1 = REGULAR CLOSE 




2 = REEL CLOSE 




3 = DONT WAIT 




For port files (note that disposition and association fields are not used): 




0 = BLOCKEXIT 




1 = NORMAL 




2 = DONTWAIT 


16 


Physical I/O count 
[47:24] Read count 
[23:24] Write count 


17 


LINK to FORMMESSAGE (standard form) 


18 


LINK to port file information. This LINK is 0 if this entry is not for a port file. 
If the LINK is nonzero, it points to an area used to contain a block of 
additional information for port files. The information contained in that block 
is listed in the following subtable. The location of each item is described by 
an offset from the start of this block of information. 

The LINKs within this block of information point to strings of characters. The 
length of each string is given in characters (not words) in the length field 
[39:20] of the LINK. The index field [19:20] of the LINK provides the word 
index in the log entry where the information starts. 

Offset Contents 

0 LINK to YOU RHOSTNAME value 

1 LINK to YOURNAME value 
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Table 12-11. Major Type 1-Minor Type 6 (cont.) 



Minor Type 


= 6 File Close Entry (LOGCLOSETYPE) 


Words 


Description 






2 


Value of MAXSEGSIZE attribute 




3 


LINK to YOURUSERCODE value 




4 


Number of messages sent 




5 


Number of messages received 




6 


Number of segments sent 




7 


Number of segments received 




8 


Number of retransmissions 




9 


Number of control frames sent 




10 


Value of MYPORTADDRESS attribute 




11 


Value of MYSUBPORTADDRESS attribute 




12 


LINK to SERVICE value 




13 


LINK to PROVIDERGROUP value 




14 


LINK to provider selected, if the CLOSE succeeded; 
otherwise, 0 (zero) 




15 


CLOSE type 

0 = ABORT 

1 = REQUEST 




16 


INITIATOR 

0 = Locally initiated 

1 = Correspondent initiated 

2 = Provider initiated 




17 


RESPOND invocation 

1 = RESPOND(ACCEPTCLOSE) 

2 = RESPOND(REJECTCLOSE) 
31 = RESPOND was not invoked 




18 


ASSOCIATED DATA transmission 

0 = ASSOCIATED DATA was sent 

1 = ASSOCIATED DATA was not sent 
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Table 12-1 1. Major Type 1-Minor Type 6 (cont.) 



Minor lype 


— o rile Close tniry iLUutLUotl TrtJ 


words 


Description 




19 ASSOCIATED DATA receipt 




0 = ASSOCIATED DATA was received 




1 = ASSOCIATED DATA was not received 


19 


External device number 


20 


Stack using the file (actor) 




[47:12] Stack number 




[31:16] Job number 




[15:16] Task number 


21 


Stack owning the file (declarer; same field format as Word 20) 


22 


LINK to family name in substandard form 


23 


Number of physical read operations initiated for the file 


24 


Number of physical write operations initiated for the file 


OK 
CO 


rlLto 1 KUt» 1 Urvt Tor QISK TlleS. 1 nlS WOiO IS -1 TOr Oiner KWQS OT TII6S. 




0 = ALIGNED180 




1 = STREAM 




5 = BLOCKED 


26 


Buffer size in words 


27 


Buffer size source 




1 = The buffer size for the file was based on the BLOCKSIZE file 




attribute because the BUFFERSIZE attribute is not applicable to this file. 




2 = The buffer size for the file was specified through an assignment to 




the BUFFERSIZE file attribute. 




3 = The buffer size for the file was based on the BUFFERGOAL memory 




management parameter of the SF (Set Factors) system command. 
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Table 12-11. Major Type 1-Minor Type 6 (cont.) 



Minor Type = 


6 File Close Entry (LOGCLOSETYPE) 


Words 


Description 


28 


Density for tape files. This word is -1 for other units. 




0 = BPI800 




1 = BPI556 




2 = BPI200 




3 = BPI1600 




4 = BPI6250 




5 = BPI38000 




6 = BPI1250 


29 


Physical Data Representation 




[47:16] EXTMODE 




[31:16] CCSVERSION 




[15:01] CCSVERSION validity bit (1 if CCSVERSION contains a valid value) 


30-end 


Variable-length data pointed to by the LINKs in this entry 


See Tables 12-22 through 12-25 for information on peripheral types. 




Table 12-12. Major Type 1-Minor Type 7 


Minor Type = 


7 Job Rejected Entry (LOGABORTTYPE) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


The reason the job was rejected. 




[31: 8] Reason for controller reject: 




1 = Discontinued out of a job queue 
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Table 12-12. Major Type 1-Minor Type 7 (cont.) 



Minor Type = 


/ jod k ejeciea cmry (luuAduk i i ire.) 


woras 


Description 




2 = Discontinued by attribute error on job start 




[23:16] Error number 




If T31 • R1 — 1 then 

ii Loi. oj — i, incii 




f~) — 1 nc:i iffiripnt <inarp tn ttfnrp thp inh filp hparlpr in thp inh rlp<srrintinn 

\J — 1 1 loUl 1 Iwld 11 0|JCIOW IU OLUIC LI IC JvlU IIIC 1 ICGUCI III LI IC }\JU VJCOlsl ILVLIUI 1 

(JOBDESC) file 




1 = Invalid priority specification 




2 = Invalid processor limit specification 




3 = Invalid I/O limit specification 




4 = Invalid card limit specification 




R = Invalid linp<? limit ^npcificatinn 

\J ~~~ IIIVCJIIVJ IIIICsO 111 1 lit- OLjfv^\-*l 1 IwCJ 11 Ul 1 




6 = Invalid wait limit specification 




7 = Invalid elapsed limit specification 




8 = Invalid Hi<;k limit snpeifiration 




11 = Invalid tape limit specification 




12 = SAVECORE job attribute value higher than job queue limit 




99 = Job had no CLASS attribute, and could not be assigned to any job 
queue due to conflicts between job attributes and job queue attributes 




100 = Invalid family specification 




101 = Invalid queue specification 




103 = Discontinued while in the queue 




104 = WFL syntax error 




105 = Insufficient disk space on the JOB family to allocate stack-rollout 
and job summary areas for the job 




!f [31: S] = 2, then the attribute error number 
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Table 12-13. Major Type 1-Minor Type 8 


Minor Type = 


8 Job/Task Abort History (LOGABORTHISTORY) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Length of STACKHI STORY task attribute value in bytes 


5-end 


STACKHISTORY task attribute value. For information about the format of 
this value, refer to the A Series Task Attribute Programming 
Reference Manual. 



The system logs Usercode Validation log entries when a usercode is validated through 
USERDATA function 3. 



Table 12-14. Major Type 1-Minor Type 9 



Minor Type = 


9 Usercode Validation (LOGVALIDATE) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


If nonzero, the mix number of the process for which the validated usercode 
was assigned. If zero, then no process was supplied or the process was not 
running. 


5 


LINK to old usercode. 


6 


LINK to validated usercode. 


7-end 


Variable-length data pointed to by the LINKS in this entry. 
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The format and contents of the File Interval log entry are almost identical to those of 
the Major Type 1, Minor Type 6 (File Close) entry. The following table indicates the 
exceptions. 



Table 12-15. Major Type 1-Minor Type 10 



Minor Type = 


10 File Interval Entry (LOGINTERVALTYPE) 


Words 


Description 


3 


Field [15:16] Minor Type = 10 


7 


Field [15: 8] is undefined. 


7 


Field [0: 1] is undefined. 


15 


Field [23: 8] is undefined. 


15 


Field [15: 8] is undefined. 


15 


Field [7:8] is undefined. 


18 


Offset 15 (CLOSE type) is undefined. 


For more information, see Table 12-11, "Major Type 1-Minor Type 6." 




Table 12-16. Major Type 1-Minor Types 11 through 14 


Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


11 Print Request (LOGPR REQ BEGIN) 

12 Print Request Complete (LOGPR REQ END) 

13 Start Printing File (LOGPR FILE START) 

14 Finish Printing File (LOGPR_FI LE_END) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Request information 

[47: 1] Restart from a checkpoint (start printing file only) 
[47: 8] Result of print (finish printing file only) 

0 = No error 

1 = Print discontinued by operator (REQUEUE,QT,DS) 
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Table 12-16. Major Type 1-Minor Types 11 through 14 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


11 Print Request (LOGPR REQ BEGIN) 

12 Print Request Complete (LOGPR_REQ END) 

13 Start Printing File (LOGPR FILE START) 

14 Finish Printing File (LOGPR FI LEEND) 




Words 


Description 






? = Print rpnositinnpd hv onprator (SKIP} 

Cm 1 Mill 1 VUVdl If wl Ivw MJ wUwIUlUI \ *J 1 \ 1 1 / 






3 = Print discontinued by fault (transform error) 






4 = Print discontinued by device (disk/printer error) 






[39: 1] Removed after print (finish printing file only) 






0 = File was not removed 






1 = File was removed 






[27:28] Print request number 




5 


LINK to usercode of request originator 




6 


LINK to origin device name (substandard form) 




7 


LINK to PRINTCHARGE attribute value 




8 


Originating job type 

1 = Session 

2 = WFL job 

3 = Jobsummary only 

4 = MCP function 

5 = Independent program 




9 


LINK to job name 




10 


LINK to FORMID attribute value 




11 


AFTER attribute value 




12 


Original or actual request size in lines 




13 


[15:16] TRAINID attribute value 




14 


LINK to PRINTERCONTROL attribute value 




15 


LINK to NOTE attribute value 
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Table 12-16. Major Type 1-Minor Types 11 through 14 (cont.) 



Minor Type = 
Minor Type = 

Minor Tvnp = 

•win i vi i y pc 

Minor Type = 


11 Print Request (LOGPR REQ BEGIN) 

12 Print Request Complete (LOGPRREQEND) 

13 Start Printing File (LOGPR FILE START) 

jl J v€Mt % 1 I ii I til ig 1 lie \LVVir r\ r.iLt vinrxi/ 

14 Finish Printing File (LOGPR_FI LE END) 


Words 


Description 


16 


Origination information 

lO 1 . 1 OJ JUU/ OCoolUI 1 IIUIIIUCI Ul UllglllalUI 

[15:16] Task number of creator 


17 


LINK to hostname of originating request, if not originated on the local host 


18 


LINK to DESTINATION attribute value 


19 


LINK to backup file name. This word is used only for Minor Types 13 (Start 
Printing File) and 14 (Finish Printing File). 


20 


Elapsed printing time in units of 2.4 microseconds. This word is used only 
for Minor Types 12 (Print Request Complete) and 14 (Finish Printing File). 


21 


File size in pages, if available. This word is used only for Minor Types 12 
(Print Request Complete), 13 (Start Printing File), and 14 (Finish Printing 
File). 


22 


LINK to PRINTPARTIAL file attribute value 


23 


LINK to REQUESTNAME print modifier value 


24-end 


Variable-length data, pointed to by the LINK words in this entry 
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Table 12-17. Major Type 1-Minor Types 15 and 16 



Minor Type = 
Minor Type = 


15 Library Link (LOGMIN LIBLINKV) 

16 Library Delink (LOGMINLIBDELINKV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words." Note that the 

miy nnmhpr in Wnrrt 0 thp miy nnmhpr nf thp> nrnppQQ linkincr fn nr 

IMIA IIUIIIUCl Ml VVUIU \J lo LI IC II HA IIUIIIUCJI Ul U It? JJIULyCoo llllrxlllg IU Ul 

delinking from the library. 


4 


Linkage/del inkage result. Negative values indicate failure. For a list of the 
possible values and their meanings, refer to the description of the 
LINKLIBRARY function in the A Series ALGOL Programming 
Reference Manual, Volume 1: Basic Implementation. 


5 


[47:12] Stack number of process linking to or delinking from the library 


6 


LINK to code file name of linking program in standard form 


7 


LINK to library attributes of linking program 


8 


Number of libraries linked to or delinked from 


9 


LINK to library information stream, containing the number of items 
specified in Word 8 

The items are of variable length. Each item contains.- 
Word 0: 

[47:12] Stack number of library process 

[15:16] Mix number of library process 

Word 1: Linkage security class of library. For a description of the 
possible values, refer to the description of word 4, field [19: 4] in 
Table 12-18, "Major Type 1-Minor Types 17 and 18." 

Word 2-end: Code file name of library in standard form 


10-end 


Variable-length data pointed to by the LINKs in this entry 
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Table 12-18. Major Type 1-Minor Types 17 and 18 

Minor Type = 17 Library Freeze (LOGMI NJLIBFREEZEV) 
Minor Type = 18 Library Resume (LOGMI N.LIBTHAWV) 

Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words." Note that the 

mix number in Word 0 is the mix number of the library process. 

4 Library status 





1 ihraiv Qfark nnmhpr 

LlUlcliy olaUrV IIUillUCi 


T35- 41 


Lihrarv ^tatp 

LIUI vll T OlCllv 


0 = 


Initiated by user 


1 _ 


inuiaieu uy iinKer 


o _ 
c — 


iNot aiiowea to lreeze 


O _ 
o — 


1 Icahlp lihrarx/ 


A — 

H — 


Nnnrpci imahle lihmrv 


R _ 

•J — 


Documincr 1 i hran/ 

rvcouiiiiiig iiuiaiy 


6 = 


Resumed library 


7 = 


Library never froze 


[30: 3] 


Sharing specification 


0 = 


Private 


1 = 


Shared by run unit 


3 = 


Shared by address space 


4 = 


Shared by all 


[27: 1] 


Permanency 


0 = 


Temporary 


1 = 


Permanent 


[26: 1] 


SET if trusted library 


[25: 2] 


LIBACCESS attribute value 


0 = 


By title 


1 = 


By function 


2 = 


By initiator 
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Table 12-18. Major Type 1-Minor Types 17 and 18 (cont.) 



Minor Type = 
Minor Type = 


17 Library Freeze (LOGMI N_LI BFREEZEV) 

18 Library Resume (LOGMI NLIBTHAWV) 


Words 


Description 




[19: 4] Linkage security class 




0 = Default class. Any user process can link to this library. 




1 = MCP class. Only user processes with the MCP linkage class can 
link to this library. 




2 = Message control system (MCS) class. 




3 = Environment software class. This class includes processes such as 
Data Management System II (DMSII), the Test and Debug System (TADS), 
and KEYEDIO. 




4 = Privileged program class. 




5 = Compiler class. Only user processes with compiler or MCP linkage 
class can link to the library. 




6-7 = Reserved for system software. 




8-15 = Site-dependent linkage classes. 


5 


Library HISTORY attribute value 
[23: 8] Reason 
[15: 8] Cause 
[7: 8] Type 


6 


LINK to code file name of library in standard form 


7-end 


Variable-length data pointed to by the LINKs in this entry 
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Table 12-19. Major Type 1-Minor Types 19 and 20 



It/I in nr Tuno — 




Minor Type = 


20 Database Close (LOGMI N DBCLOSEV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Result (negative values indicate failure) 


5 


LINK to code file name of the database user 


c. 
O 


LINK to usercode of the database user 


7 


LINK to the access code of the database user 


8 


LINK to the external name of the database 


9 


LINK to the internal name of the database 


i n 
1 u 


UdldUdbti iHIa lUcl lUIICdUUM 




[47:12] Stack number 




[31:16] Job number 




[15:16] Mixnumber 


11 


SIB level information at database open 




[47: 8] SIB format level 




[35:12] Access routines implementation level 




[23:12] Update level of description file 




[11:12] Logical database number 


12 


Database open information 




[47:12] Stack number of the local buffer manager 




[15: 1] SET if database is running under SWAPPER 




[14: 1] SET if database has label equation 




[13: 6] ASN of local buffer manager 




[7:8] open type 


13-end 


Variable-length data pointed to by the LINKs in this entry 
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Table 12-20. Major Type 1-Minor Types 21 and 22 



Minor Type = 
Minor Type = 


21 Database Freeze (LOGMIN DBFREEZEV) 

22 Database Resume (LOGMI NDBRESUMEV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to the database name 


5 


LINK to code file name of access routines 


6 


Stack number information 
[47:12] Database stack number 
[31:12] Access routine stack number 


7-end 


Variable-length data pointed to by the LINKs in this entry 
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The Major Type 1, Minor Type 25 (File Statistics) entry is logged only for processes 
using anonymous file accounting. For further information, refer to "Using Anonymous 
Task and File Accounting" earlier in this section. 



Table 12-21. Major Type 1-Minor Type 25 



Minor Type 


= 25 File Statistics Entry (LOGMI N_FI LESTATSV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Number of disk files used 


5 


Elapsed I/O time for disk files 


6 


Transaction count (number of logical I/O operations) for disk files 


7 


Physical read count for disk files 


8 


Physical write count for disk files 


9 


Number of nondisk files used 


10 


Elapsed I/O time for nondisk files 


11 


Transaction count (number of logical I/O operations) for nondisk files 


12 


Physical read count for nondisk files 


13 


Physical write count for nondisk files 
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Major Type = 2 Maintenance Entry (LOGMAJMAINT) 

Tables 12-22 through 12-25 present peripheral type information that is referred to by 
many of the log entry descriptions for Major Type 2. 



Table 12-22. Peripheral Logical Types 



Logical Type 


Description 


0 


NO UNIT 


1 


Disk 


'2 


ODT 


3 


Remote 


A 




o 


Ri tfforoH lino nrintor 
DUIIclcU Mile pillllcl 


7 


Train printer 


8 


HYPERchannel 


9 


Card reader 


11) 


Pseudo Card Reader 


1 1 


Card punch 




Not used 


1 3 


7-trapk macrnptir tanp 


1 A 

14 


O f ko/^I/ MD7 f«na It 

y-iracK inkz. rape n 


J. o 


j-llaOIV |JI laotJ-el iulajcu u y ui gjl(JU|J-lAJUcu IcUUIUIIIg luur\j 

tape III 


16 


Data comm NSP and LSP 


17 


Pack 


18 


SCSI unit 


20 


Host control 


21 


Floating point array processor (FPSAP) 


22 


Printer 


23 


Image printer (in line printer mode) 


24 


Special 


27 


ICP 


38 


EBCDIC buffered printer 
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Table 12-22. Peripheral Logical Types (cont.) 



Logical Type 


Description 




39 


Unbuffered printer 


40 


Voice channel 




45 


Tape 




Table 12-23. Peripheral Subtypes 


Device 


Peripheral 
Subtype 


Description 


For PACK (DLP types HT1, 
HTS1, HTS2, SMD1) 


0 


215 pack 




1 


215 pack (new) 




2 


225 pack 




3 


235 pack 




4 


206 pack sequential 




5 


206 pack interlaced 




6 


207 pack sequential 




7 


207 pack interlaced 




8 


659 pack sequential 




9 


659 pack interlaced 




10 


677 pack sequential 




11 


677 pack interlaced 




12 


3652 pack sequential (1440-byte 
sectors) 




13 


3652 pack interlaced (1440-byte sectors) 




14 


3675 pack sequential (1440-byte 
sectors) 




15 


3675 pack interlaced (1440-byte sectors) 




16 


SMD(214) pack 




17 


SMD (226) pack 
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Table 12-23. Peripheral Subtypes (cont.) 



Device 


Peripheral 
Subtype 


Description 




18 


3652 pack sequential (180-byte sectors) 




19 


3675 pack sequential (180-byte sectors) 




20 


3864 12-MB solid state disk 




21 


3864 24-MB solid state disk 




22 


3864 36-MB solid state disk 




23 


3864 48-MB solid state disk 






ooo4 du-md soiia state uisk 






3Rfi4 79-MR <?olirl <?tatp rlkk 




26 


B9494-12 (3680) pack sequential 




27 


SMD (236) pack 




28 


SMD (256) pack 




29 


SCSI/131 pack 




30 


SCSI/130 pack 




31 


SCSI/564 pack 




32 


3682 pack 




33 


3680 pack sequential (1440-byte 
sectors) 




34 


3680 pack interlaced (1440-byte sectors) 




35 


3680 (180-byte sectors) 






Twin tnrnn nark 




o / 


^^1/674. nark 




oo 


^P^I/PRf) nark 




on 


oL.oi/0o*f pacK 




40 


SCSI/287 pack 




41 


SCSI/552 pack 




42-43 


Reserved for internal use 




44 


SCSI/286 pack 




45 


SCSI/546 pack 




46-48 


Reserved for internal use 
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Table 12-23. Peripheral Subtypes (cont.) 



Device 


Peripheral 
Subtype 


Description 




49 


IPI/M2671Ppack \ 




50 


SCSI/ 1367 pack 




63 


New SCSI/I PI pack 


For TAPE (DLP types MT1, 
MT2, MT3, MT5, MT6, 


0 


Invalid 




2 


Magtape II (9-track NRZ) 




3 


Magtape III (9-track PE) 




4 


Magtape group-coded recording (GCR) 




6 


9-track NRZ tape (no extended status). 




7 


9-track PE tape (no extended status). 




9 


Half-inch cartridge tape. 


For UIO Data comm (DLP 

i v/i ? lxwiwi V/Wi Mill 

types FR1, FR2, FR3, SCI, 
SC2, SC3, SC4, SC5) 


1 


Network support processor (NSP)— models 
1 and 2 




2 


NSP-multiple host model 




3 


Line support processor 
(LSP)-subbroadband, programmable 
read-only memory (PROM) type 




4 


LSP— subbroadband, random access 
memory (RAM) type 




5 


LSP- broadband (bit) type 




6 


NSP -blocked 




7 


NSP-multiple host, blocked 




8 


NSP— data communications data link 
processor (DCDLP), blocked 


TP1,TP2,TP3,TP5) 


n 


450/750-lines-per-minuts train printer. 




1 


1 100/1 500-lines-per-minute train printer. 




3 


Other printers using a translation table. 


For Host Controls (DLP type 
HC2) 


1 


Host control-1 and host control-2 
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Table 12-24. Peripheral Densities 





Peripheral 




Device 


Density 


Description 


TAPE 


0 


800-bits-per-inch (bpi) NRZ 




3 


1600-bpi PE 




4 


6250-bpi GCR 




5 


38000-bpi half-inch cartridge tape 




6 


1250-bpi quarter-inch cartridge tape 



Table 12-25. Peripheral DLP Types 



Logical 
Type 


Peripheral 
Subtype 


Peripheral 
Density 


DLP 

Abbreviation 


DLP Name 


1 


2 


2 


D5N1 


5N DISK 


2 






ODT1 


OPERATOR DISPLAY 


2 






ODT2 


OPERATOR 
DISPLAY-2 


7 


0,1 




TP1 


450/750/1100/1500 
LPM TRAIN PRINTER 


7 


2 




TP2 


B9246-X BUFFERED 
PRINTERS 


7 






TP3 


B924-B/B924-C 
1200/2000 LPM 
BUFFERED DRUM 
PRINTERS 


8 






HY 


HYPERchannel 


9 






CR1 


CARD READER 


11 






CP1 


CARD PUNCH 


14 


2 


0 


MT3 


9-TRACK NRZ MAG 
TAPE 


14 


2 


0 


MTFIPS1 


Fl PS TAPE 


15 


3 


3 


MT1 


PE MAG TAPE 


15 


4 


3,4 


MT2 


GCR MAG TAPE 
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Table 12-25. Peripheral DLP Types (cont.) 



Logical 
Type 


Peripheral 
Subtype 


Peripheral 
Density 


DLP 

Abbreviation 


DLP Name 


15 




3,4 


MT5 


GCR 

FORMATTER-TYPE 
MAG TAPE 


15 


3 


3 


MT6 


STREAMER TAPE 


15 


3,4 


3,4 


MTFIPS1 


Fl PS TAPE 


15 


4 


5 


MTFIPS3 


MTFIPS3 TAPE 


15 


4 


6 


SCSITAPE 


SCSI TAPE 


16 


1 




SCI 


DATA COM M NSP: 
STANDARD (MODEL 
1 &2) 


16 


2 




SC2 


DATA COM M NSP: 
MULTIPLE HOST 


16 


3 




FR1 


DATA COMM LSP: 

SUB-BROADBAND 

(PROM) 


16 


4 




FR2 


DATA COMM LSP: 

SUB-BROADBAND 

(RAM) 


16 


5 




FR3 


DATA COMM LSP: 
56KB BROADBAND 
BIT 


16 


6 




SC3 


DATA COMM NSP: 

BLOCKED 

MESSAGES 


16 


7 




SC4 


DATA COMM NSP: 
EXTENDED MEMORY 


16 


8 




SC5 


DATA COMM NSP: 
DCDLP 


1 


3, 5, 7, 9, 11 




HT1 


STANDARD HOST 
TRANSFER (DISK 
PACK) 


17 


4-11 




HTS1 


SEQUENTIAL HOST 
TRANSFER (DISK 
PACK) 


17 


26 




HTS2 


SEQUENTIAL HOST 
TRANSFER 2 (DISK 
PACK) 
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Table 12-25. Peripheral DLP Types (cont.) 



Logical 
Type 


Peripheral Peripheral DLP 
Subtype Density Abbreviation 


DLP Name 


17 


17,27,28 SMD1 


STORAGE MODULE 
DEVICE (DISK PACK) 


17 


29,30,31,37 SCSIDISK 


SCSI Disk 


17 


29, 30, 31, 37 PKISCSI(NATIVE) 


Native SCSI Disk 


17 


32 IPIPKl 


IPI 9399-H PACK 


17 


49 IPIPK2 


IPI M9730 PACK 


20 


1 HC2 


HOST CONTROL-2 


26 


IP 


IMAGE PRINTER 


27 


ICP1 


INBUILT 

COMMUNICATIONS 
PROCESSOR 


40 


VI M3 


VOICE INTERFACE 
MODULE-3 


59 


SCSI1 


SCSI UNIT (CAN BE 
DISK, TAPE, OR 
OTHER TYPE OF 
SCSI UNIT) 


Table 12-26. Major Type 2-Minor Type 1 1 


Minor Type = 


11 Library Maintenance Compare (MLLIBERR) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Source information word, consisting of 






[42: 1] This bit is ON if the source is another host system (network file 
transfer) 




[41: 1] Disk flag (1 = disk) 






[40: 1] Tape flag (1 = tape) 






[31:12] Index of first word in 30 sector source library maintenance record 
on which compare failed 
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Table 12-26. Major Type 2-Minor Type 11 (cont.) 



Minor Type = 


11 Library Maintenance Compare (MLLIBERR) 


Words 


Description 




[19:20] Disk address 


5 


First source word on which the compare failed 


6 


Destination information word 




[42: 1] This bit is ON if the destination is another host system (network file 




transfer) 




[41: 1] Disk flag (1 = disk) 




[40: 1] Tape flag (1 = tape) 




[31:12] Index of first word in 30 sector destination library maintenance 




record on which compare failed 




[19:20] Disk address 


7 


First destination word on which compare failed 


8 


External device number of the source unit 


9 


External device number of the destination unit 



Table 12-27. Major Type 2-Minor Type 12 



Minor Type = 


12 Mainframe Error Entry (MLMAINFRAMERR) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


MCP ID 

[47:12] = System serial number 
[35:12] = Mark digit 
[23:12] = Level number 
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Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Type = 


12 Mainframe Error Entry (MLMAINFRAMERR) 


Words 


Description 




Lii:i^j — uycie numDer 




Note that the system serial number field ([47:12]) in this word does not 




have the capacity to store numbers greater than 4095. It is suggested that 




the user use the 16-bit system serial number field ([47:16]) of Word 9 of 




the Major Type 6, Minor Type 1 (Halt/Load) entry to avoid getting a 




misrepresented system serial number. 


5 


Time mainframe event occurred 


6 


Mainframe configuration information 




[47: 8] = System type 




The rest of this word has one of three different formats, according to the 




value found in [47:8]. The possible values, and the formats they imply for 




the rest of the word, are as follows: 




1 — A O 
1 = A ^ 




[19:20] = Data processor mask 




5 = A3 




6 = A9 




7 = A 15 




9 = A 10 




10 = A 5 




15 = A 12 




16 = A 1 




19 = A 4 




20 = Micro A 




[31: 8] = Data processor mask 




[23: 8] = I/O processor mask 




[15: 8] = Memory mask 




17 = A 17 




[39: 3] = Console state 




0 = Clock set at console 
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Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Type = 


12 Mainframe Error Entry (MLMAI NFRAMERR) 


Words 


Description 




1 = Clock set by partition 1 




2 = Clock set by partition 2 




[36: 1] = Console clock validity 




0 = Console state and console ID not used 




1 = Console state and console ID are valid 




[35: 4] = Console ID field 




0, 1, or 2 depending on which console formed the report. 




[23: 8] = RMM mask 




I/: j.j — uibin iguibi icu i/vj piuLcboui \\\Jr/ 




0 = IOP 0 is distinguished 




1 = IOP 1 is distinguished 




[6: 1] = Distinguished task control processor (TCP) 




0 = TCP 0 is distinguished 




1 = TCP 1 is distinguished 




21 = A 16 




[39: 3] = Console state 




0 = Clock set at console 




1 = Clock set by partition 1 




2 = Clock set by partition 2 




[36: 1] = Console clock validity 




0 = Console state and console ID not used 




1 = Console state and console ID are valid 




r*ii- ill j"* I _ irN _ I _ I 

Lao: Hi — UUIIbUlC ID IICIU 




0, 1 , or 2 depending on which console formed the report. 




[23: 8] - RMM mask 




[7:4] = Distinguished I/O processor (IOP) 
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Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Type = 


12 Mainframe Error Entry (MLMAINFRAMERR) 


Words 


Description 




0 = IOP 0 is distinguished 




1 = IOP 1 is distinguished 




[3:4] = Distinguished task control processor (TCP) 




0 = TCP 0 is distinguished 




1 = TCP 1 is distinguished 


7-14 


Not used 


15-18 


These words are described under "Fields Determined by Error Entry Type" 




following this table. 


19 


Error entry information 




[47: 1] = Report system error action 




[39: 4] = Box subtype 




[35: 4] = Box number of second box 




[31: 8] = Cause of failure 




CPM causes (all processor types) 




1 = Retryable instruction 




2 = Alarm interrupt in user code into CM 1 




3 = Alarm interrupt in MCP code into CM 1 




4 = Interrupt into CM 2 




5 = First instruction retry failed 




6 = All instruction retries failed 




7 = Only CPM entered CM 3 




IOP/HDU error causes 




1 = Fail IOCB was detected 




2 = Fail RD was found 




3 = Hung I/O finally terminated 



continued 



8600 0478-100 



12-81 



SUMLOG 



Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Type = 


12 Mainframe Error Entry (MLMAINFRAMERR) 


Words 


Description 




4 = No fail RD or fail IOCB 




5 = Memory related IOP error in RD 




6 = Cannot cause a completion event 




7 = Port death event caused 




Memory error causes (MSMS) 




1 = Fail 1 interrupt 




2 = Memory parity interrupt 




3 = Memory parity and fail 1 interrupt 




4 = Fail 1 into CM 2 




5 = Fail register found by polling 




6 = I/O exception memory error 




Environment fault causes 




1 = Fan fault 




2 = Fan fault, box has been removed from system 




3 = Fan fault, system has been halted 




4 = Temperature fault 




5 = Power regulator fault 




System error action causes 




1 — Box removed 




c. — box removal auonea 




3 = Box reconfigured 




4 = Low memory removed 




5 = MSM THRESHOLD exceeded 




6 = Threshold exceeded (removal of only CPM aborted, CPM can be 
freed) 




Reconfiguration causes 




1 = Box freed 
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Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Type = 


12 Mainframe Error Entry (MLMAINFRAMERR) 


Words 


Description 




2 = Box acquired 




3 - Box swapped 




Mainframe event causes 




1 = System was halt/loaded 




2 = System dump was requested 




3 = Maintenance enabled/disabled for requestor 




4 = CPM Init Light response 




5 = MSM Init Light response 




6 = Unrecognized fail report from MAINTLINE 




7 = POWERNET event detected 




8 = Nonusable time from TCP communicate 




9 = CPM DEADSTOP report 




TCP error causes 




1 = Unexpected TCP service interrupt 




RMM error causes 




1 = Fail register detected 




Console action causes 




1 = HALT attempt 




5 = CONTINUE attempt 




6 = LOAD attempt 




7 = FORCE DUMP attempt 




8 = BOOT LOAD attempt 




Maintlink event causes 




1 = Unrecognized MS-MCP message 




2 = Unexpected MS-MCP response 




3 = ID in response did not match pending MCP-MS message 




4 = Maintlink message was timed out by the MCP 
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Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Type = 


12 Mainframe Error Entry (MLMAINFRAMERR) 




Words 


Description 






5 = MCP software error with maintlink 






6 = Maintlink came up on new unit 






[23: 8] = Box action 






Type of Entry = Reconfiguration 






1 = Operator requested 






Other types of entries 






1 = Threshold exceeded 






2 = Requestor to memory count excessive 






3 = Memory to requestor count excessive 






4 = Memory down 






5 = CPM lost while taking dump 






6 = Not used 






/ — VVUUIU IIUl alloWCI WIICII UlalCU 






8 = CPM jumped to CM 2 






10 = Memory reconfigured in CM 3 






12 = Box reDorted a FAN FAULT 






[15: 4] = Type of box 






1 = Central processor module (A 12, A 15) 






2 = I/O processor module 






3 = Memory control module 






4 = Memory module 






5 = Maintenance diagnostic processor 






6 = Card tester 






7 = Memory storage module 






8 = Undefined 






9 = Auxiliary processor module 
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Table 12-27. Major Type 2-Minor Type 12 (cont.) 



Minor Tvnp = 


12 Mainframe Error Entrv fMLMAINFRAMERR) 

± £- iviciii in ai i ic i— 1 1 v>i t.iiiiy v ivi ivi^^i iiir rvitivib.ixrv/ 


Words 

VVUI Uo 


Dpcrrintinn 

l|f UUI 1 




10 = Host data unit 




11 = A Series I0P processor (A 1, A 2, A 3, A 4, A 5, A 9, A 10) 




1 t~ — I \ 1 V l < - . 




[11: 4] = Box number 




[7: 8] = Type of entry 




1 = CPM <X> interruDt 




9 — IOP <^ Y intern int 
t. — lv_/r "^A-^ llllcliupi 




3 = Memory <X> interrupt 




4 = System error action 




R — Mpiinframp p\/pnt 

sJ — ivialM 1 1 at i ic cvci 1 1 




6 = System reconfiguration action 




"7 — Roy pnuirnnmpnt f at lit 
/ — DUA CI 1 V II Ul II 1 ICI 11 laUIL 




8 = Failed system module 




9 = TCP error 




10 = RMM error 




11= Console action 




12 = Maintlink Event 


20-29 


These words are described in "Fields Determined by Error Entry Type" 
following this table. 



Fields Determined by the Error Entry Type 

This subsection describes Words 15 to 18 and Words 20 to 29. The contents of these 
words vary according to the value contained in the Type of Entry field [7:8] of Word 19, 
Error Entry Information. The descriptions that follow are grouped according to the 
Type of Entry value they are associated with. 
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Type of Entry = CPM <X> Interrupt 
Word Description 

15 Task serial number 

16 Fail register (A 12 and A 15 will be 0) 

17 Not used 

18 RCW where interrupt occurred 

19 Error entry information (See the description of Word 19 in Table 12-27, 
"Major Type 2-Minor Type 12.") 

20 PI 

21 P2 

22 P2 TAG 
23-29 Not used 



Type of Entry = IOP <X> Interrupt 
Word Description 

15 RMM = Result descriptor (if FAUCAUSE = 5); Number of port that failed 
(if FAUCAUSE = 6); Number of DTU that failed (if FAUCAUSE = 8); All 
others = not used 

16 RMM = not used; All others = Fail register 
17-18 Not used 

19 RMM = not used; All others = Error entry information (See the description 

of Word 19 in Table 12-27, "Major Type 2-Minor Type 12.") 

20-29 RMM = Not used; All others = Failure data from fail IOCB (when fail IOCB 

was detected) 



Type of Entry = Memory <X> Interrupt 
Word Description 



M~«. I 



INUl U3CU 

16 Fail register 

17 Failed control word if box type = memory storage module 

Bit [45:01] is true for single bit memory errors logged while the LAO 
diagnostic option is set (A 12, A 15, and A 17) 

24-bit fail register extension, valid only for board types MCSIM and 
SCHED= memory storage module (A 12 and A 15) 

18 Memory subsystem module (MSM) box model information 
[7:4] Memory Type 

1=2 million words per SU 

continued 
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continued 

Word Description 

2 = 4 million words per SU 

19 Error entry information (See the description of Word 19 in Table 12-27, 

"Major Type 2-Minor Type 12.") 

20-29 Not used 



Type of Entry = System Error Action 



Word Description 

15 Not used 

16 Task information (only if bit [47: 1] of Word 19 is 0) 
17-18 Not used 

19 Error entry information (See the description of Word 19 in Table 12-27, 
"Major Type 2-Minor Type 12.") 

20-29 Not used 



Type of Entry = Mainframe Event 



The format of mainframe event entries depends on the failure cause recorded in field 
[31: 8] of Word 19. 



Cause of Failure 

1 



Word 

15 
16 
17 
18 
19 



Description 

System was halt/loaded (Large Systems) 
Not used 

Mainframe configuration 
Not used 

System halt information 

Error entry information 

[43:03] The system halt information 

[43:01] The halt information is valid 

[42:02] Cause of system halt 

0 = The console is incapable of supplying 
halt information. Valid for console halts. 

1 = Halt was due to manual intervention 

2 = Halt was due to internal problems 

3 = Cause of halt could not be detected 

continued 
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continued 

Cause of Failure 



Word 

20 
21 

22-29 



Description 

Halt/load reason word 1 
Halt/load reason word 2 
Not used 



15 
16 

17-18 
19 

20 
21 

22-29 



System was halt/loaded (EMS systems) 
Not used 

Mainframe configuration 
Not used 

Error entry information (See the description of 
Word 19 in Table 12-27, "Major Type 2-Minor 
Type 12.") 

Halt/load reason word 1 
Halt/load reason word 2 
Not used 



15 
16 

17 
18 
19 

20 
21 

22 

23-end 



System dump was requested 
Task serial number 

Mainframe configuration at time of dump (same 
format as [39:40] of Word 5) 

Not used 

Dump was fatal 

Error entry information (See the description of 
Word 19 in Table 12-27, "Major Type 2-Minor 
Type 12.") 

Dump reason word 1 

Dump reason word 2 

Not used 

As many linked mainframe information words as 
necessary for A 1 , A 2, A 3, A 4, A 5, A 9, A 10 
systems 



15-29 



CPM I nit Light response. This is a normal function 
and does not represent an error. 

Not used 



15 



MSM I nit Light response. This is a normal function 
and does not represent an error. 

Not used 
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continued 



Cause of Failure 



Word 



Description 



16 



Encoded halt/load reason 



18-29 



Not used 



6 



Unrecognized fail report from MAINTLINE 



7-16 



Data from the HMC buffer 



7 



POWER NET event detected 



15 



Not used 



16 



Fail register 1 



[47: 3] 4 = Type of entry 

[44: 5] 1 = Message format 

[39: 8] 2 = Fail entry length 

[23: 8] Logical unit type (hex) 



CO 




Peripheral unit 


CI 




110 base 


C2 




BX387 disk exchange 


C3 




B9387 disk controller 


C4 




B9389 disk controller 


El 




CPM 


E2 




HDU 


Fl 




MSM 


FF 




A 12 mainframe 



[15:16] Logical unit number 



[47:42] Powernet events 

[47:1] One or more power supplies margined 

[42:1] +5V overvoltage fail 

[41:1] +5V undervoltage fail 

[40:1] -5.2V overvoltage fail 

[39:1] -5.2V undervoltage fail 

[38:1] -2.0V overvoltage fail 

[37:1] -2.0V undervoltage fail 

[36:1] -3.3V overvoltage fail 

[35:1] -3.3V undervoltage fail 



17 



Fail register 2 
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continued ^ 
Cause of Failure Word Description 

[29:1] +5Vfail 1 
[28:1] +5Vfail2 
[27:1] -5.2V fail 1 
[26:1] -5.2V fail 2 
[25:1] -2.0V fail 1 
[24:1] -2.0V fail 2 
[23:1] -3.3V fail 1 
[22:1] -3.3V fail 2 
[21:1] +12V fail 2 
[20:1] -12V fail 2 
[19:1] -4.5V fail 2 

[18:1] No response to power net monitor 
[17:1] Input module failure 
[16:1] +5V keep alive fail 1 
[11:1] Fan failure 
[10:1] Air quality failure 

[09:1] Temperature warning ( 
[08:1] Over temperature failure 
[07:1] 0 = System mode 

1 = Local mode 
[06:1] 0 = Powered on 

1 = Powered off 

[05:06] Most recent event pointer, set to the bit 
number of the event 

19 Entry info 

[07:8] (FATYPE) 5 = FAMAINEVNTV 

[31:8] (FACAUSE) 7 = SYSPOWERNET 

8 Nonusable time from TCP communicate 

1 5 Not used 

16 Nonusable time 
17-18 Not used 

19 Error entry information 

20-29 Not used 

continued 
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continued 

Cause of Failure Word 

9 

15 
16 
17 
18 

20-29 



Description 

CPM DEADSTOP report 

DEADSTOP word (for example, 
4"DEAD00000251") 

DEADSTOP parameter (for example, 
4"C6C1E4D3E340") 

DEADSTOP line number (for example, 
4"000023B568") 

Not used 

Not used 



Type of Entry = System Reconfiguration Action 



Word Description 

1 5 Not used 

16 Task info 
17-18 Not used 

19 Error entry information (see above) 

20-29 Not used 



Type of Entry = Failed System Module 
Word Description 

17 CPM flip-flops: 

[44: 5] PCU flip-flops: 
[44: 1] = PPRGVC 
[43: 1] = PPRGRC 
[42: 1] = PACE 
[41: 1] = PACO 
[40: 1] = PLHE 
[37: 2] RU flip-flops: 
[37: 1] = RWCODE 
[36: 1] = RWCPER 
[23:24] MAU flip-flops: 
[23: 1] = MAQERR 

continued 
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continued 
Word 



Type of Entry 

lil..J 
VVUIU 

15-17 
18 
20 
21 

22-29 



Description 

[22: 1] = MCATPE 
[21: 1] = MEMTPE 
[20: 1] = MEDFOP 
[19: 1] = MIQPE 
[18: 1] = MCACJE 
[17: 1] = MIDCPE 
[16: 1] = MAQUNF 
[15: 1] = MCACPF 
[14: 1] = MCATCF 
[13: 1] = MCACEF 
[12: 1] = MCAPE 
[11: 1] = MCCAPE 
[10: 1] = MCCOPE 
[ 9: 1] = MCEPE 
[ 8: 1] = FATAL 
[ 7: 1] = MCAERR 
[ 6: 1] = MCPE 
[ 5: 1] = MCVLE 
[ 4: 1] = MCFTE 
[ 3: 1] = MCCRPE 
[ 2: 1] = MRQFUL 
[ 1: 1] = MJRPE 
[ 0: 1] = MOUERR 

TCP Error 

Description 
Not used 

RCW where interrupt was taken 

Not used 

P2 

Not used 
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Type of Entry = RMM Error 

Word Description 

Cause of failure Fail register detected 

7-14 PCD information 

15-17 Fail analysis information 

18 Control information 

20-29 Fail register report 



Type of Entry = Console Action 
Word Description 

7-18 Not used 

20 [47: 5] load reason 

6 = Console load 

7 = Force dump 

8 = Boot load 

16 = Console load (autoload after deadstop 166) 

17 = Console load (autoload after deadstop 366) 
[23: 6] Mask of requestors failed disconnect 

[17: 6] Mask of requestors in partition 

[ 5: 1]TCP(1) disorderly halt 

[ 4: 1] TCP(O) disorderly halt 

[ 3: 1] IOP(l) disorderly halt 

[2: 1] I OP(0) disorderly halt 

[ 1: 1] MlC(l) disorderly halt 

[0:1] MIC(O) disorderly halt 

21 First through sixth EBCDIC characters of PCD name 

22 [47:16] = Seventh and eighth characters of PCD name 
[31:16] = PCD hash ID 

23-29 Not used 
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Type of Entry = Maintlink Event 

Word Description 

7-18 Not used 

20 MAINTLINEINFO 

[47:12] MAINTLINEIR stack number 

[35:12] Stack number of head of queue of waiters for 
response 

[23: 5] Message type for which the independent runner 
is awaiting a response 

[18:15] Maintline ODT unit number 

[ 3: 1] Maintline is up 

[ 2: 1] Maintline has error 

[1:1] Maintline idle (not awaiting response) 

[ 0: 1] Maintline has outstanding memory storage unit 
(MSU) update 

21 MAINTLINEINF02 

[47: 8] Expected type of response 

[39: 8] Expected subtype of response 

[31:32] Message ID of message requires response 

22 MAINTLINE INF03 

[47: 1] 10 timed out on an 10 to the MAINTLINE unit 
[46: 1] The MAINTLINE has been up 
[45: 1] A NAK limit error has occurred 



[31:32] Message ID of most recent ??CONSL FAIL 
MS-MCP message 



23-29 Not used 



Table 12-28. Major Type 2-Minor Type 14 



Minor Type = 14 DFO Error Entry (MLDFOERROR) 
Words Description 

This log entry type is not currently used. 
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Table 12-29, "Major Type 2-Minor Type 16," describes the original minor type used for 
logging I/O errors. In a future release, all I/O errors will be logged in the Major Type 2, 
Minor Type 21 (MLIOEXCEPTION) entry, and Minor Type 16 will be deimplemented. 

Table 12-29. Major Type 2-Minor Type 16 



Minor Type = 16 iOP I/O Error Entry (MLIOERRORHDP) 
Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

4 EMS/HDU/RMM log type 

[47: 8] EMS/HDU/RMM log type 

1 = This is an error-recovery log entry. 

2 = This is an error-IOCB log entry. 

The rest of the entry is in either of two different formats, depending on the value contained in 
EMS/HDU/RMM log type, above. 

If this is an error-recovery log entry, as indicated by a value of 1 in field [47: 8], then the 
remainder of the log entry has the following format: 

4 Retry information. 

[39: 8] Log variant 

1 = Log entry is for normal error recovery and all information for a retry 
is present. 

2 = Log entry is for limited error recovery and some of the information 
for each retry is not present. The DLP command and the IOP CONTROL 
are not present for retry I/O operations. This entry type is only available on 
EMS systems. 

[27:12] Number of retries that were logged 
[15: 1] Not recovered 

0 = The I/O was recovered 

1 = The I/O could not be recovered 
[13: 2] Extended status control 

0 = No extended status information is available 

1 = The extended status information was read correctly 

2 = An error occurred while trying to read the extended status 

3 = No error occurred. The statistical data could not be logged. 
[11: 1] Extended status area 

continued 
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Table 12-29. Major Type 2-Minor Type 16 (cont.) 



Minor Type = 16 IOP I/O Error Entry (MLIOERRORHDP) 
Words Description 

0 = The extended status information was put in the extended result 
descriptor area (words 24-33) 

1 =. The extended status information was put in the variable length 
information area 

[10: 1] HDU system 

0 = This is not an HDU system 

1 = This is an HDU system 
[9:10] Extended status byte length 

5 UNIT information. 
[47:12] Logical unit number 
[35:12] Internal device index 

[23: 6] Logical unit type (See Table 12-22, "Peripheral Logical Types.") 
[17: 6] Unit subtype 
[11:12] DLPID 

6 File and job information 

[47: 4] Number of file and job information items logged. 

File information includes the file title, the internal name, and the serial 
number. Job information is the job name. 

[43: 4] EMS/HDU/RMM log version number. 

0 = Before Mark 3.4.0 release 

1 = Command word 2 was added 

2 = RMM machines were included (retry area was enlarged) 

3 = I/O statistics words 3 and 4 were added 

4 = I/O statistics words 3 and 4 for RMM machines were added 
[13: 1] RMM machine 

0 = This is not an RMM machine; refer to Word 4, field [10: 1] 

1 = This is an RMM machine 

[12: 1] Result descriptors are missing from list. 

continued 
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Table 12-29. Major Type 2-Minor Type 16 (cont.) 



Minor Type = 


16 IOP I/O Error Entry (MLIOERRORHDP) 


Words 


Description 




[11:12] File and job information location. 




The word offset in this entry where the file and job information starts. 


The remainder of the fixed portion of the log entry contains information about the original I/O. 


7 


IOP control word 




[19:20] IOP CONTROL (EMS systems and HDU systems) 




RMM control word (RMM systems) 








fiq, 11 VA/nrH mnrip 




u — una racier moue operation 




1 = Word mode operation 


8 


DLP address for EMS systems and HDU systems. 




Path word for RMM machines 




[47:16] Port number 




Lol:lbj Control number 




[15:16] Unit number 


9 


Device number 


10 


For HDU systems, the device number of the DLP used during the I/O. For 




EMS systems, this word is 0. 


11 


RMM bus information 


12 


IOP state and result 


13 


I/O START time 


14 


STACK numbers 




[47:12] STACK number of I0CB owner 




[35:12] STACK number of I/O initiator 


15 


MIX numbers of process charged for the I/O action 




[47:16] JOB number 




[31:16] TASK number 



continued 
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Table 12-29. Major Type 2-Minor Type 16 (cont.) 



Minor Type = 


16 I0P I/O Error Entry (MLIOERRORHDP) 


Words 


Description 


16 


I/O control word 


17 


AREA length descriptor 
[27:20] Length of area 


18 


AREA address descriptor 
[31:32] Address of area 


1 Q 


Logical resuii aescnpior 


20 


Exception ID 


21 


DLP command (word 1 ) 




uLr result iwora d 


23 


DLP result (word 2) 


24-33 


Extended result descriptor area. Used when extended result descriptor 
information is 10 words or less. Otherwise, the variable length information 
area is used (see below). 


34 


I/O statistics (word 1) 

[47:24] Total number of read I/O operations to unit since the last halt/load. 
[23:24] Total number of write I/O operations to unit since the last halt/load. 


35 


I/O statistics (word 2) 

[47:24] Total number of read errors to unit since the last halt/load. 
[23:24] Total number of write errors to unit since the last halt/load. 


36 


DLP command (word 2) 


37 


I/O statistics (word 3) 

[47:24] Total number of read errors successfully recovered by the controller. 

[23:24] Total number of write errors successfully recovered by the 
controller. 


38 


I/O statistics (word 4) 

Total bytes transferred to or from unit since halt/load or the last time the 
counter was initialized. 



continued 
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Table 12-29. Major Type 2-Minor Type 16 (cont.) 



Minor Type = 


16 IOP I/O Error Entry (MLIOERRORHDP) 


Words 


Description 


This section contains retry entries of up to eight words each. The number of retries (Word 4) that 
are logged is variable, so this section is of variable length. The format of each entry is as follows: 


39-N 


RETRY entries 


Entry Word 0 


Retry DLP command (word 1) (not present if the field [39:8] of Word 4 
stores a log variant of 2) 


Entry Word 1 


Retry DLP result (word 1) 


Entry Word 2 


Retry DLP result (word 2) 


Entry Word 3 


[47: 1] Actual retry 

0 = Entry is not actual attempt to retry I/O (for example, repositioning a 
tape) 

1 = Entry is an actual attempt to retry I/O 

[19:20] RETRY IOPCONTROL (not present if the field [39:8] of Word 4 
stores a log variant of 2) 

[31:32] Control field 


Entry Word 4 


Retry IOP STATE and RESULT 


Entry Word 5 


Retry DLP command (word 2) 


Entry Word 6 


Path word (RMM machines) 
[47:16] Port number 
[31:16] Control number 
[15:16] Unit number 


Entry Word 7 


IOP miscellaneous information word (RMM machines) 
[47: 1] Entry is an actual retry 
[46:17] LRD 
[29:10] Exception ID 


This section contains file, job, and extended status information. Because the length of the 
previous section varies, the location of the starting word of this section is also variable. The index 
to the starting word of this section is in field [1 1:12] of Word 6. The number of file and job 
information items (field [47:4] of Word 6) is variable, as is the length of each item. The first 
word of each item specifies the type and length of the item. 



continued 
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Table 12-29. Major Type 2-Minor Type 16 (cont.) 



Minor Type = 


16 IOP I/O Error Entry (MLIOERRORHDP) 


Words 


Description 


N+l-end 


Variable-length information 


0 


Item descriptor 




[39:20] length of item (including this word) 




[19:20] TYPE of item 




1 = Item is SERIAL NUMBER information 




2 = Item is FILE TITLE information 




3 = Item is JOB NAME information 




7 = Item is INTERNAL NAME information 




9 = Item is EXTENDED STATUS information 


If TYPE = 1 


(SERIAL NUMBER) 




Note: Words 1 through 3 of the SERIAL NUMBER 




information are not valid for disks or packs. 


1 


LEBCONTROL 


2 


GENEALOGY1 




[47: 9] Label level 




[38: 1] 1 if CYCLE was specified 




[37:14] CYCLE 




[23: 8] VERSION 




[15: 1] 1 if FILESECTION was specified 




[14:15] FILESECTION number 


3 


GENEAL0GY2 




[47:16] System serial number of system that created file 




[31: 4] GENERATION attribute 




[27:11] SAVEFACTOR attribute 




[16:17] CREATIONDATE (Julian) 


4 


SERIALNO in EBCDIC (Present only if the unit is a pack or mag tape) 



continued 
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Table 12-29. Major Type 2-Minor Type 16 (cont.) 



Minor Type = 


16 IOP I/O Error Entry (MLIOERRORHDP) 


Words 


Description 


If TVDC O 

IT 1 irt £ 


INLt 1 1 1 Lt; 


1 


Area number of the file on pack or disk. This word is all ones if no valid 
row index is present or if the unit is not a pack or disk. 


2-n 


If the length of the FILE TITLE item is greater than two, the rest of the item 
is the file title in standard form. 


If TYPE = 3 


(JOB NAME) 


1 « 

1-n 


The job name in standard form 


If TYPE = 7 


(INTERNAL NAME) 


1-n 


The internal name in standard form 


If TYPE = 9 


(EXTENDED STATUS) 


1-n 


The EXTENDED STATUS information (used when the extended status data 
length is greater than 10 words) 


If this is an error-IOCB log entry, as indicated by a value of 2 in field [47: 8] of Word 4, then the 
remainder of the log entry has the following format: 


4 


Number of DLP result area words 

[ 7: 8] Number of words of information in the DLP result area of the Error 
IOCB 


5-n 


Error IOCB information 

This section contains the DLP result area information of the error IOCB. 
Each DLP result area word is stored as 52 bits of information starting at 
Word 5 in the log entry. Figure 12-1, "DLP Result Format for IOP I/O 
Errors," shows the format of this area. 

Refer to individual system reference manuals for a more detailed 
description of the information returned in these words. Note that the whole 
error IOCB is not returned. 



Area Word 0 Area Word 1 











3- -c: — 




DLP result 


DLP result 


DLP result 


DLP result 




Word 0 Tag 


Word 0 


Word 1 Tag 


Word 1 




(4 bits) 


(48 bits) 


(4 bits) 


(48 bits) 





Figure 12-1. DLP Result Format for IOP I/O Errors 



For more information about peripheral types, see Tables 12-22 through 12-25. 
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The Hardware Configuration log entry uses LINKs to store information in a tree 
structure. One LINK is at the top of the tree; this LINK describes a region that 
contains several additional LINKs. Each of these LINKs describes a region that 
contains information about data processors, I/O processors, memory, or peripherals. 
For further information about the LINKs used in this entry, refer to the "Format of 
Hardware and Software Configuration LINK Words" subsection earlier in this section. 

The fixed part of the hardware configuration entry consists of the information in 
Table 12-30, "Major Type 2-Minor Type 17." 



Table 12-30. Major Type 2-Minor Type 17 



Minor Type = 


17 Hardware Configuration (HARDWARE CONFIG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


General information 




[47: 3] Partition number (A 12, A 15, A 16, and A 17 systems) 




[44: 5] Number of data processors in system 




[39: 8] Number of I/O processors in system 




[31: 8] System type. For a list of the possible values, refer to the 




description of Word 3, field [15:16] in Table 12-66, "Major Type 10-AII 




Minor Types." 




[23: 8] Total number of memory subsystem modules (MSMs) (A 12, A 15, 




A 16, and A 17) 




[15: 4] EMODE level 


5 


LINK to the hardware information 


6-end 


Variable-length hardware information pointed to by the LINK in Word 5 
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All of the actual hardware configuration information resides in the variable part of the 
configuration entry. Accessing any of this information requires that the LINK at Word 
5 be examined. 

The LINK at Word 5 contains the following values: 
LINKTYPE 1 
LINK_VERSION 0 
ITEM_COUNT 10 (LINKs) 
ITEMWIDTH 1 (word) 

The format of the region described by the LINK at Word 5 varies, depending on the 
system type. For A 1, A 2, A 3, A 4, A 5, A 6, A 9, A 10, and Micro A systems, this region 
has the following format: 



Offset 


Contents 


LINKTYPE 


0 


LINK to data processor information 


2 


1 


LINK to I/O processor information 


3 


2 


LINK to memory information 


4 


3 


LINK to peripheral information 


5 


4 


LINK to extended pack information 


6 


6 


LINK to physical memory configuration (A 9 or A 10 
systems) 


20 



The value given in each LINK in the preceding table and the format of the information 
corresponding to each LINK are given under "Link Descriptions for EMS Systems" 
later in this section. 

On A 12 and A 15 systems, the format is as follows: 



Offset 


Contents 


LINK_TYPE 


0 


LINK to data processor information 


2 


1 


LINK to I/O processor information 


11 


2 


LINK to memory information 


10 


3 


LINK to peripheral information 


17 


4 


LINK to extended pack information 


19 


5 


LINK to I/O base information 


15 



The value contained in each LINK in the preceding table and the format of the 
information corresponding to each LINK are given under "Link Descriptions for HDU 
Systems" later in this section. 
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On A 17 systems, the format is as follows: 



Offset 


Contents 


LINKTYPE 


0 


LINK to data processor information 


2 


1 


LINK to I/O orocessor information 


21 


2 


LINK to memory information 


10 


3 


LINK to peripheral information 


17 


4 


LINK to extended pack information 


19 


5 


LINK to path group information 


28 


7 


LINK to task control processor 


29 


9 


LINK to continuation information 


207 



The value contained in each LINK in the preceding table and the format of the 
information corresponding to each LINK are given under "Link Descriptions for A 17 
Systems" later in this section. 

Note: If the LINK to continuation information in an A 17 hardware 
configuration entry is not 0, then the hardware configuration 
information is distributed over two or more log entries. Refer to the 
description of "LINK [5] + 9 : Continuation Information (A 17 
Systems)" later in this section. 

On A 16 systems, the format is as follows: 



Offset Contents LINKTYPE 

0 LINK to data processor information 2 

1 LINK to I/O processor information (RMM and IOM 21 
machines) 

2 LINK to memory information 10 

3 LINK to peripheral information 17 

4 LINK to extended pack information 19 

5 LINK to path group information (RMM and IOM 25 
machines) 

6 0 (not used) 

7 LINK to task control processor 29 

8 LINK to DOMAIN status 30 



The value contained in each LINK in the preceding table and the format of the 
information corresponding to each LINK are given under "Link Descriptions for A 16 
Systems" later in this section. 

The array indices given in the Offset column in the preceding tables are not absolute 
indices; they are relative to the START INDEX of the LINK at Word 5. For example, 
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on A 12, and A 15 systems, the LINK to I/O base information is found at array entry 
[5] + 5. 

Link Descriptions for EMS Systems 

LINK [5] + 0 : Data Processor Information (EMS Systems) 

This LINK has the following values: 
LINKJYPE 2 
LINK_VERSION 0 

ITEM_COUNT number of data processors 
ITEM_WIDTH 7 (words) 

Each data processor entry has the following format: 
Entry Word Description 

0 PROCESSOR_NUMBER 

1 PROCESSOR_TYPE 

1 = A2 

5 = A3 

6 = A9 

9 = A 10 

10 = A 5 
16 = Al 

19 = A 4 

20 = Micro A 

2-3 0 

4 PROCESSOR_IOP_MASK 

I/O processors that this data processor can see; bit "i" is ON if this data 
processor can see I/O processor number "i". 

5 PROCESSOR_CACHE_STATUS 

0 = Not present 

1 = Disabled 

2 = Enabled 

6 0 

LINK [5] + 1 : I/O Processor Information (EMS Systems) 

This LINK has the following values: 
LINKJYPE 3 

continued 
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continued 



LINKVERSION 0 

ITEMCOUNT Number of I/O processors 
ITEM WIDTH 4 (words) 

Each I/O processor entry has the following format: 
Entry Word Description 

0 IOP_NUMBER 

1 IOP_TYPE 

Currently, this word always stores a 4. 

2 IOPFIRMWARELEVEL 
Currently, this word is always 0. 

3 IOP PROCESSOR MASK 



Data processors that this I/O processor can see; bit "i" is ON if this I/O 
processor can see data processor number "i". 



LINK [5] + 2 : Memory Information (EMS Systems) 

This LINK has the following values: 
LINKVERSION 0 
LINKTYPE 4 

ITEM_COUNT Number of memory chunks 
ITEM_WIDTH 5 (words) 

Each memory entry has the following format: 
Entry Word Description 

0 This word always stores a 3. 



Prior to the Mark 3.9 system software release, this word contained the box 
or ASN number and the following fields: 

[ 1: 1] GLOBAL MEMORY 



1 MEMORY_START_ADDRESS 

2 MEMORY_END_ADDRESS 

3 MEMORY PROCESSOR MASK 



Data processors that can see this memory; bit i is ON if I/O processor 
number i can see this memory. 



continued 
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continued 

Entry Word Description 

4 MEMORYJOPMASK 

The I/O processors that can see this memory; bit i is ON if data processor 
number i can see this memory. 

Prior to the Mark 3.9 system software release, it was possible for two entries to be 
made for the same chunk of GLOBAL Memory. Two entries are made if one data 
processor has read-only access to some part of GLOBAL Memory. One entry has 
GLOBALMEMORY and WRITE_OK SET, and the data processor mask is SET 
to show all processors except the one with read-only access. Another entry has 
GLOBAL MEMORY SET, WRITE_OK RESET, and the data processor mask SET to 
show the processor with read-only access to that area of memory. 

LINK [5] + 3 : Peripheral Information (EMS Systems) 

This LINK has the following values: 
LINK_TYPE 5 
LINKVERSION 0 

ITEM_COUNT Number of peripheral units 
ITEM_WIDTH 3 (words) 

Each peripheral information entry has the following format: 
Entry Word Description 

0 Peripheral unit information 
[47:12] Physical unit number 

[35: 83 Logical type (See Table 12-22, "Peripheral Logical Types.") 

[27: 8] Subtype or the number 63, indicating that the peripheral subtype is 
stored in Word 2. For a list of subtypes, refer to Table 12-23, "Peripheral 
Subtypes." 

[19: 4] Density (See Table 12-24, "Peripheral Densities.") 
[15: 1] 1 if unit is saved 
[14: 1] 1 if unit is reserved 

[13: 1] 1 if unit has been seen ready since the last halt/load 
[12: 1] 1 if unit is currently available to group 
[11:12] Reserved 

1 LINK to path information 

2 If field [27: 8] of word 0 stores a value of 63, then this word contains the 
peripheral subtype in bits [16:17]. See Table 12-23, "Peripheral 
Subtypes." 
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PERIPHERAL_SEEN_RY is SET if the unit has been ready at any time since the last 
halt/load, even if the device is not currently ready. 

PERIPHERAL AVAIL is SET if the peripheral is currently available to the group. In a 
loosely coupled system, paths to a device from two or more groups can be present. In 
this case, one of these groups "acquires" the device and the device becomes available to 
that group. The other groups might have a valid path to the device, but that device is 
not available to those groups. 

The subtype information reported for printer, pack, and disk devices is based on the 
information in the unit table of the MCP. The unit table is built from information in 
the configuration file. If a printer, pack, or disk has not been seen as ready, its subtype 
often might not be correct. 

The I/O Processor (IOP) paths correspond to the LINK TYPES that are in Entry 
Word 1 in a peripheral entry. They are defined in the following subsection. 

I/O Processor Path 

IOP path information is described by a LINK with the following values: 
LINKTYPE 9 
LINK_VERSION 0 
ITEM COUNT Number of paths 
ITEMWIDTH 2 (words) 

STARTJNDEX 0 

Each IOP path entry has the following format: 
Entry Word Description 

0 [47: 8] PATHJD 
[39: 8] IOP_NUMBER 

[31: 4] IOPPORTNUMBER 

[27: 4] LEM PORT NUMBER 

[23: 4] RELATIVEDLP (behind the base) 

[19: 4] RELATiVE UNiT (behind the DLP) 

[15:12] DLPJD 

[ 3: 1] PATH RESERVED 

[2:3] Reserved 

1 FIRM WAR E_LEVEL 

(4 hex digits, right-justified) 
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LINK [5] + 4 : Extended Pack Information (EMS Systems) 

This LINK has the following values: 
LINKTYPE 6 
LINK_VERSION 0 
ITEM_COUNT Number of packs online 
ITEM_WIDTH 5 (words) 

Each extended pack entry has the following format: 
Entry Word Description 

0 [47:12] Unit number 

[35: 8] Family index number 
[27: 1] MODE (IN - 0, I/O = 1) 
[26:27] Reserved 

1 Serial number (in EBCDIC characters) 

2 [47: 8] Number of characters in the pack name 
[39:40] First five characters of the pack name 

3 Next six characters of the pack name 

4 Last six characters of the pack name 

LINK [5] + 6 : Physical Memory Configuration (A 9 and A 10 Systems) 

This LINK has the following values: 
LINKTYPE 20 
LINK_VERSION 1 
ITEM_COUNT 9 
ITEMWIDTH 1 (word) 

Each A 9 memory configuration entry has the following format: 
Entry Word Description 

0 [15: 8] Number of processors (Always 1 on an A 9) 

[7:8] Processor number 

1-8 These words share the following format. Note that each of these words is 0 

if the corresponding hub is not present. 

[12: 4] Module Type 

2 = A 9 memory 

[ 8: 1] Upper submodule present 

[ 7: 1] Lower submodule present 

continued 
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continued 

Entry Word Description 

[6:3] Configuration address 
[1:2] Submodule online bits 

Each A 10 memory configuration entry has the following format: 
Entry Word Description 

0 [15: 8] Number of processors 

[ 7: 8] Processor number 

1-4 and 6-9 These words share the following format. Note that each of these words is 0 

if the corresponding hub is not present. 

[34: 4] Memory module ID interlacing bits 

[26: 1] Addr3 interlace bit submodule 1 

[25: 1] Addr2 interlace bit submodule 1 

[24: 1] Addr3 interlace bit submodule 0 

[23: 1] Addr2 interlace bit submodule 0 

[22: 3] Submodule 1 configuration address 

[12: 4] Module type (always 4) 

[ 8: 1] Submodule 1 present 

[ 7: 1] Submodule 0 present 

[ 6: 3] Submodule 0 configuration address 

[1:1] Submodule 1 online 

[ 0: 1] Submodule 0 online 

5 [7:8] Processor number 

Link Descriptions for HDU Systems 

LINK [5] + 0 : Data Processor Information (HDU Systems) 

This LINK has the following values: 
LINKTYPE 2 
LINKVERSION 0 

ITEM_COUNT Number of data processors 
ITEM WIDTH 7 (words) 
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Each data processor entry has the following format: 
Entry Word Description 

0 PROCESSOR_NUMBER 

1 PROCESSOR_TYPE 

7 = A 12, A 15 

2 PROCESSOR_GMM_PORT_ADDRESS 
(four characters, left-justified) 

3 P ROCESSORFI R MWAR ELEVEL 

[39: 8] Stored Logic Level Major field 

[31:16] Stored Logic Level Minor field 

[15:16] Creation Date: constructed as (year - 1970) * 1000 + 
day_of_year 

4 PROCESSOR_IOP_MASK 

I/O processors that this data processor can see; bit i is ON if this data 
processor can see I/O processor number i. 

5 Not used 

6 A15 PROCESSOR HARDWARE LEVEL 
[35.12] ERL Minor field 

[23: 8] ERL Major field 

[15: 4] EMODE LEVEL: 1 = Non-ASD 

[ 7: 8] MACHINE TYPE: 6 = A 15 

LINK [5] + 1 : I/O Processor Information (HDU Systems) 

This LINK has the following values: 
LINK TYPE 11 
LINKVERSION 0 

ITEM_COUNT Number of HDUs on system 
ITEMWIDTH 4 

Each I/O processor entry has the following format: 
Entry Word Description 

0 HDU information 
[47: 1] = FREEd 
[46:47] = Not used 

1 HDU name 

2 HDU firmware 

continued 
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continued 

Entry Word Description 

3 Message level interface (MLI) LINK 

The MLI LINK word has these values: 
LINKTYPE 12 
LINKVERSION 0 

ITEM_COUNT Number of MLIs per HDU 
ITEM WIDTH 3 

The MLI entry has the following format: 
Entry Word Description 

0 MLI information 
[47: 1] = Reserved 
[46: 1] = No path 
[45:46] = Not used 

1 MLI name 

2 LEM LINK or base LINK 

The LEM LINK word has these values: 
LINKTYPE 13 
LINKVERSION 0 

ITEM_COUNT 1 (only 1 LEM possible per MLI) 
ITEM_WIDTH 2 

The LEM entry has the following format: 
Entry Word Description 

0 Lem name 

1 Base LINK 

The base LINK word has these values: 
LINKTYPE 14 
LINKVERSION 0 

ITEM_COUNT Number of bases on LEM or MLI 
ITEM WIDTH 1 
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The base entry has the following format 
Entry Word Description 

0 Base name 

LINK [5] + 2 : Memory Information (A 12, A 15 Systems) 

This LINK has the following values: 
LINKTYPE 10 
LINKVERSION 1 
ITEM_COUNT 37 
ITEMWIDTH 0 

Each memory entry has the following format: 

Entry Word Description 

0 MEMMASK 

1-128 PAGEINFO 

The format of PAGEINFO is as follows: each word contains eight 6-bit fields 
for a total of 1024 fields. Each field represents a page of logical memory. 
This logical page does not correspond to a physical page of memory in the 
MSM. 

The format of each 6-bit field is as follows: 
[ 5: 1] = To be saved 
[4:5] = Page status 

0 = Undefined 

1 = Not present 

2 = Available 

3 = In use 

4 = Saved 

5 = Not used 

6 = Bad 

7 = Memory Disk 

129 MSUCONFIG 

This word is composed of 32 1-bit fields. Each field indicates whether the 
MSU which it represents is physically present. 

MSU M of SIM S corresponds to bit 8 * S + M. 

130 MSUENABLED 

This word is composed of 32 1-bit fields, which are indexed in the same 
manner as MSUCONFIG. Each field indicates whether the MSU which it 
represents is enabled. 

continued 
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Entry Word 

131 



132 



Description 

MSUSAVED 

This word is composed of 32 1-bit fields, which are indexed in the same 
manner as MSUCONFIG and MSU ENABLED. Each field indicates whether 
the MSU which it represents is marked as to-be-saved for the next 



halt/load. 




MSM status 


roc /in 
[35: 4J = 


sim status 


ro l . oi — 
[61: d\ = 


Maintenance Bus mode 


[27: 1] = 


Fan Fault 


[26: 1] = 


MSM name 


[25: 1] = 


Time-of-day valid 


[24: 1] = 


Temperature fault 


[23: 1] = 


Power fault 


[22: 6] = 


Halt/load reason 


[16: 6] = 


ERL 


[10: 1] = 


Scheduler status 


[9: 1] = 


Maintenance bus enable 


[8: 1] = 


Scrub memory enable 


[7:4] = 


Model number 


[ 3: 4] = 


Box type (MSM II type = 5) 



LINK [5] + 3 : Peripheral Information (HDU Systems) 

This LINK has the following values: 
LINKTYPE 17 
LINKVERSION 0 

ITEM COUNT Number of units on system 
ITEMWIDTH 3 

Each peripheral information entry has the following format: 
Entry Word Description 

0 Unit information 

[47: 8] = Peripheral type (See Table 12-22, "Peripheral Logical Types.") 
[39: 8] = Peripheral subtype (See Table 12-23, "Peripheral Subtypes.") 
[31: 9] = Density (See Table 12-24, "Peripheral Densities.") 
[22: 1] = Saved 
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Entry Word Description 

[21: 1] = URed 

[20: 1] = URed for maintenance 
[19: 1] = Ready 
[18: 1] = Available 
[17: 1] = No path to unit 
[16:17] = Not used 

1 Unit name 

2 Path LINK 

The path LINK word has these values: 
LINK_TYPE 18 
LINKVERSION 0 

LINK_COUNT Number of paths (DLPs) to the unit 
ITEM_WIDTH 3 

The entry for each path has the following format: 
Entry Word Description 

0 Path information 

[47: 1] = No path to unit through this DLP: DLP is URed, UR MAINT, 
freed, or no path 

[46:43] = Not used 

[ 3:4 ] = Subsystem protocol 

0 = Hex 

1 = EBCDIC 

2 = Decimal 

3 = ASCII 

1 DLP name 

2 Firmware information 
[47: 8] = Firmware length 
[39:40] = Firmware ID 

LINK [5] + 4 : Extended Pack Information (HDU Systems) 

This LINK has the following values: 
LINKTYPE 19 
LINK_VERSION 0 
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ITEMCOUNT Number of packs on line 
ITEMWIDTH 6 

Each extended pack entry has the following format: 
Entry Word Description 

0 Extended information 

[47: 8] = Family index number 
[39: 1] = Pack mode 

0 = Read only 

1 = Read/write 
[38:39] = Not used 

1 Unit name 

2 Serial number (in EBCDIC characters) 

3 [47: 8] Number of characters in the pack name 
[39:40] First five characters of the pack name 

4 Next six characters of the pack name 

5 Last six characters of the pack name 

LINK [5] + 5 : I/O Base Information (HDU Systems) 

The LINK word has these values: 
LINKTYPE 15 
LINK_VERSION 0 

ITEM COUNT Number of bases on the system 
ITEM_WIDTH 3 

The base entry has the following information: 
Entry Word Description 

0 Base information 
[47: 1] = Reserved 

[46: 1] = Reserved for maintenance 
[45: 1] = No path 
[44:45] = Not used 

1 Base name 

2 DLP LINK 
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The DLP LINK word has these values: 
LINKTYPE 16 
LINK_VERSION 0 

ITEM_COUNT Number of DLPs in the base 
ITEM_WIDTH 3 

The DLP entry has the following information: 
Entry Word Description 

0 DLP information 
[47: 8] = DLP type 
[39: 1] = Freed 
[38: 1] = Reserved 

[37: 1] = Reserved for maintenance 
[36: 1] = No path 
[35:361 = Not used 

1 DLP name 

2 Firmware level 

Link Descriptions for A 17 Systems 

LINK [5] + 0 : Data Processor Information (A 17 Systems) 

This LINK has the following values: 
LINK_TYPE 2 
LINK_VERSION 0 

ITEM_COUNT Number of data processors 
ITEM_WIDTH 7 (words) 

Each data processor entry has the following format: 
Entry Word Description 

0 PROCESSOR_NUMBER 

1 PROCESSOR_TYPE 

17 = A 17 

2 Processor is reserved (four characters, left-justified). 

3 PROCESSORFIRMWARELEVEL 
[39: 8] Stored Logic Level Major field 
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Entry Word 



Description 



[31:16] Stored Logic Level Minor field 



[15:16] Creation Date: constructed as (year - 1970) * 1000 + 
day_of_year 



4 



PROCESSOR IOP MASK 



I/O processors that this data processor can see; bit i is ON if this data 
processor can see I/O processor number i. 



5 



Not used 



6 



A17 PROCESSOR HARDWARE LEVEL 



[35:12] Engineering release level minor field 



[23: 8] Engineering release level major field 



[15: 4] EMODE LEVEL 1 = Non-ASD 



[ 7: 8] MACHINE TYPE: 6 = A 15 



LINK [5] + 1 : I/O Processor Information (A 17 Systems) 

Note: The format of HO information logged for A 17 systems is changing in 
a future release. The new format will be the same as that described 
under "LINK [5] + 1 : Version 2 I/O Processor Information (IOM 
and RMM Systems) " later in this section. A program can determine 
which format is being used by inspecting the LINK_VERSION value, 
which will change from 0to2 when the format changes. 

A warning is now displayed whenever a process uses the LOGjGET 
or LOG READ procedures of the SDASUPPORT library to read 
a Hardware Configuration log entry. Programs that use the 
SDASUPPORT library can suppress this warning message by first 
invoking the LOG SELECT procedure and passing a value of 1021 
to the STYPE parameter. 

This LINK has the following values: 
LINK_TYPE 21 
LINK_VERSION 0 
ITEM_COUNT 1 
ITEM_WIDTH 5 

Each I/O processor entry has the following format: 
Entry Word Description 

0 IOP information 



[47:44] = Not used 
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Entry Word 

1 

2 
3 
4 



Description 

[ 3: 4] = IOP box number 
IOP firmware word 1 
IOP firmware word 2 
DTU LINK 
Port LINK 



The data transfer unit (DTU) LINK word has these values: 



LINKTYPE 
LINK_VERSION 
ITEM_COUNT 
ITEM WIDTH 



22 
0 

Number of DTUs on the system 
3 



Each DTU entry has the following format: 
Entry Word Description 

0 DTU information 

[47: 1] = DTU is reserved 
[46: 1] = In use 
[45: 1] = Dead 
[44: 1] = Out of service 
[43: 1] = Online 
[42: 5] = Not present 
[41: 4] = (Reserved field) 
[37: 1] = RMM number 
[36:21] = (Reserved field) 
[15:16] = DTU identification 

1 DTU firmware word 1 

2 DTU firmware word 2 
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The Port LINK word has these values: 
LINKTYPE 23 
LINKVERSION 0 

ITEM_COUNT Number of ports on the system 
ITEM_WIDTH 3 

Each port entry has the following format: 
Entry Word Description 

0 Port information 

[47: 1] = Port is reserved 

[46: 1] = In use 

[45: 1] = Dead 

[44: 1] = Out of service 

[43: 1] = Online 

[42: 1] = (Reserved field) 

[41: 4] = Subsystem protocol 

0 = SCSI maintenance bus (SMB) 

1 = Message level interface (MLI) 

2 = Intelligent peripheral interface (I PI) 

3 = Small-computer system interface (SCSI) 

[37: 1] = Resource management module (RMM) number 
[36:21] = (Reserved field) 
[15:16] = Port identification 

1 Port firmware word 1 

2 Port firmware word 2 

LINK [5] + 2 : Memory Information (A 17 Systems) 

This LINK has the following values: 
LINK_TYPE 10 
LINKVERSION 1 
ITEM_COUNT 37 
ITEM WIDTH 0 
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Each memory entry has the following format: 

Entry Word Description 

0 MEM MASK 

1-128 PAGEINFO 

The format of PAGEINFO is as follows: each word contains eight 6-bit fields 
for a total of 1024 fields. Each field represents a page of logical memory. 
This logical page does not correspond to a physical page of memory in the 
MSM. 

The format of each 6-bit field is as follows: 
[5: 1] = To be saved 
[4:5] = Page status 

0 = Undefined 

1 = Not present 

2 = Available 

3 = In use 

4 = Saved 

5 = Not used 

6 = Bad 

7 = Memory Disk 

129 MSUCONFIG 

This word is composed of 32 1-bit fields. Each field indicates whether the 
MSU that it represents is physically present. 

MSU M of SIM S corresponds to bit 8 * S + M. 

130 MSU ENABLED 

This word is composed of 32 1-bit fields, which are indexed in the same 
manner as MSUCONFIG is. Each field indicates whether the MSU which it 
represents is enabled. 

131 MSUSAVED 

This word is composed of 32 1-bit fields, which are indexed in the same 
manner as MSUCONFIG and MSU ENABLED are. Each field indicates 
whether the MSU that it represents is marked as to-be-saved for the next 

132 



halt/load. 




MSM status 


[35: 4] = 


SIM status 


[31: 2] = 


Maintenance bus mode 


[27: 1] = 


Fan fault 


[26: 1] = 


MSM name 


[25: 1] = 


Time-of-day valid 


[24: 1] = 


Temperature fault 



continued 



8600 0478-100 



12-121 



SUMLOG 



continued 

Entry Word Description 

[23: 1] = Power fault 

[22: 6] = Halt/load reason 

[16: 6] = ERL 

[10: 1] = Scheduler status 

[9: 1] = Maintenance bus enable 

[8: 1] = Scrub memory enable 

[ 7: 4] = Model number 

[ 3: 4] = Box type (MSM II type = 5) 

LINK [5] + 3 : Peripheral Information (A 17 Systems) 

This LINK has the following values: 
LINKTYPE 17 
LINK_VERSION 0 

ITEM_COUNT Number of units on the system 
ITEM_WIDTH 3 

Each peripheral information entry has the following format: 
Word Description 

0 Unit information 

[47: 8] = Peripheral type 

[39: 8] = Peripheral subtype 

[31: 9] = Density 

[22: 1] = Saved 

[21: 1] = Unit reserved 

[20: 1] = Unit reserved for maintenance 

[19: 1] = Ready 

[18: 1] = Available 

[17: 1] = No path 

[16: 1] = Mirroring 

[15: 1] = Caching 

[14: 1] = Cache mode 

[13:14] = Not used 

1 Unit device number 
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Word Description 

2 Path link 

The path LINK word has the following values: 
LINK_TYPE 18 
LINKVERSION 0 

LINK_COUNT Number of paths to the unit 
ITEM_WIDTH 3 

The entry for each path has the following format: 
Entry Word Description 

0 Path information 

[47: 1] = No path to unit through this control unit (CTL). The CTL is 
reserved through a UR (Unit Reserved) system command, in maintenance 
mode due to a UR MAINT command, freed, or has no path. 

[46:43] = Not used 

[ 3:4 ] = Subsystem protocol 

0 = Hex 

1 = EBCDIC 

2 = Decimal 

3 = ASCII 

1 CTL number 

2 Firmware information 
[47: 8] = Firmware length 
[39:40] = Firmware identification 

LINK [5] + 4 : Extended Pack Information (A 17 Systems) 

This LINK has the same format as LINK [5] + 4 under "Link Descriptions for HDU 
Systems" in this section. 

LINK [5] + 5 : Path Group Information (A 17 Systems) 

The LINK word has these values: 
LINKTYPE 25 
LINKVERSION 0 

ITEM_COUNT Number of path groups on the system 
ITEM WIDTH 2 
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The path group entry has the following information: 
Entry Word Description 

0 Unit link or control unit link 

1 Control link or unused 

The unit LINK word has these values: 
LINKTYPE 26 
LINK_VERSION 0 

ITEM_COUNT Number of units in the path group 
ITEM_WIDTH 2 

The unit entry has the following information: 
Entry Word Description 

0 Unit information 

[47: 8] = Peripheral type 
[39: 1] = Freed 
[38:39] = Not used 

1 Unit device number 

The control unit LINK word has these values: 
LINKTYPE 27 
LINKVERSION 0 
ITEM_COUNT 1 
ITEMWIDTH 5 

The control unit entries are identical in format and information to the control entries. 
The control LINK word has these values: 

LINKTYPE 28 

LINKVERSION 0 

ITEM COUNT Number of controls in the path group 

ITEMWIDTH 5 

Each control and control unit entry has the following information: 
Entry Word Description 

0 Control information 

[47: 8] = Control type 
[39: 8] = Firmware format 
[31: 1] = Freed 
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Entry Word Description 



LoU 


J. J — 


uiiii icbcivca lui iiidinicnance 


[29 


1] = 


Path broken 


[28 


1] = 


Path reserved 


[27 


1] = 


No path 


[26. 


1] = 


Online 


[25: 


1] = 


In use 


[24. 


1] = 


Control unit 


[23: 


24] = 


Not used 



1 External device number 

2 Firmware level 

3 Path status 

[23: 4] = Port selected ordinal port number; 0=none 
[19: 1] = Fourth port usable 
[18: 1] = Third port usable 
[17: 1] = Second port usable 
[16: 1] = First port usable 

[15:16] = Identification of fourth port (lowest priority) 

4 Path status word 2 

[47:16] = Identification of third port 

[31:16] = Identification of second port 

[15:16] = Identification of first port (highest priority) 

LINK [5] + 7 : Task Control Processor Information (A 17 Systems) 

The task control processor LINK has the following values: 
LINKTYPE 29 
LINK_VERSION 0 
ITEM_COUNT 1 
ITEM WIDTH 3 

The task control processor entry has the following format: 
Entry Word Description 

0 Distinguished TCP mask 

1 TCP identification word 1 
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Entry Word Description 

2 TCP identification word 2 

See Tables 12-22 through 12-25 for information on peripheral types. 

LINK [5] + 9 : Continuation Information (A 17 Systems) 

The continuation information LINK indicates that the hardware configuration is 
described by multiple log entries. If the hardware configuration information fits in a 
single log entry, then the continuation information LINK word is 0. Otherwise, this 
LINK has the following values: 

LINK_TYPE 207 

LINK_VERSION 4 

ITEM_COUNT 1 

ITEM_WIDTH 1 

The continuation information LINK points to a word that has one of the following 
values: 

Value Meaning 

1 First of multiple log entries 

2 An intermediate log entry 

3 Last of multiple log entries 

When the hardware configuration is described by multiple log entries, each log entry 
has the same structure. That is, words 0 through 9 appear as described in Table 12-30, 
"Major Type 2-Minor Type 17," and the LINK words appear at their usual offsets 
beginning with Word 10. However, if the information pointed to by a particular LINK 
cannot fit in the current log entry, that LINK word is zero and the information appears 
in one of the other log entries. 

Link Descriptions for A 16 Systems 

LINK [5] + 0 : Data Processor Information (A 16 Systems) 

This LINK has the following values: 
LINK_TYPE 2 
LINKVERSION 1 

ITEM_COUNT Number of data processors 
ITEM WIDTH 7 (words) 
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Each data processor entry has the following format: 



Entry Word Description 

0 PROCESSOR_NUMBER 

1 PROCESSOR_TYPE 

21 = A 16 

2 DOMAINJNFORMATION 



[47:16] (Reserved field) 

[31: 8] Domain number in which requestor resides 
[23: 8] Requestor number 
[15: 8] Requestor status 

0 = Undefined 

1 = Ready 

2 = Saved 

3 = Unavailable 
[7:7] Requestor status subtype 

If requestor status = saved, 

1 = Not in use 

2 = User saved 

3 = MCP inhibit 

If requestor status = unavailable, field is not used 
For other requestor status values, this field is 0 
[0: 1] Corrective action can be taken 

0 = False 

1 = True 

3 PROCESSORFIRMWARELEVEL 
[39: 8] Stored logic level major field 
[31:16] Stored logic level minor field 

[15:16] Creation date: constructed as (year - 1970) * 1000 + 
day_of_year 

4 PROCESSOR_IOP_MASK 

I/O processors that this data processor can see; bit i is ON if this data 
processor can see I/O processor number i. 

5 (Reserved word) 

6 PROCESSORHARDWARELEVEL 
[39: 4] SC level field 

[35:12] ERL minor field 
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Entry Word Description 

[23: 8] ERL major field 
[15: 4] EMODE LEVEL: 

3 = GAMMA 
[ 7: 8] MACHINETYPE: 

21 = A 16 



LINK [5] + 1 : I/O Processor Information (A 16 Systems) 

Note: The format of I/O information logged for A 16 systems is changing in 
a future release. The new format will be the same as that described 
under "LINK [5] + 1 : Version 2 I/O Processor Information (IOM 
and RMM Systems)" later in this section. A program can determine 
which format is being used by inspecting the LINK_VERSION value, 
which will change from 0to2 when the format changes. 

A warning is now displayed whenever a process uses the LOG_GET 
or LOGREAD procedures of the SDASUPPORT library to read 
a Hardware Configuration log entry. Programs that use the 
SDASUPPORT library can suppress this warning message by first 
invoking the LOG SELECT procedure and passing a value of 1021 
to the STYPE parameter. 

This LINK has the following values: 
LINKTYPE 21 
UNK_VERSION 1 
ITEM_COUNT Number of lOMs 
ITEM WIDTH 5 (words) 

Each I/O processor entry has the following format: 
Entry Word Description 

0 IOM information 

[47: 8] IOM domain number 

[39: 1] IOU firmware valid 

[38: 1] This IOM contains the distinguished IOU. 

[37: 1] IOU is ready. 

[36: 4] IOU status (when not ready) 

1 = Not in use 

2 = User saved 

3 = MCP inhibited 
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Entry Word 



Description 



4 = Unavailable 
[32:14] Not used 
[18: 8] IOM status 

0 = Freed 

1 = In use 

2 = Saved 

3 = Unavailable 
[10: 7] IOM status subtype 

If IOM Status field = 2 (saved): 

1 = Not in use 

2 = User saved 

3 = MCP inhibit 

If Status field = 3 (unavailable): 

1 = Domain powered off 

2 = Module not present 

3 = Module uninitialized 

4 = CSD interface unavailable 

5 = CSD interface saved 

6 = Memory interface unit (MIU) failed to initialize. 

7 = Peripheral configuration diagrams (PCDs) do not match. 
Otherwise, this field is not used. 

[ 3: 4] IOM requestor number 



1 



IOU firmware word 1 



2 



IOU firmware word 2 



3 



DTU LINK 



4 



Port LINK 



The DTU LINK word has these values: 



LINK TYPE 



22 



LINK VERSION 



1 



ITEM COUNT 



Number of DTUs on the IOM 



ITEM WIDTH 



3 (words) 
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Each DTU entry has the following format: 
Entry Word Description 

0 DTU information 

[47: 1] = DTU is reserved. 
[46: 1] = In use 
[45: 1] = Dead 
[44: 1] = Out of service 
[43: 1] = Online 
[42: 1] = Unavailable 
[41:26] = Not used 
[15:16] = DTU identification 

1 DTU firmware word 1 

2 DTU firmware word 2 

The port LINK word has these values: 
LINKTYPE 23 
LINKVERSION 1 

ITEM_COUNT Number of ports on the IOM 
ITEM_WIDTH 3 (words) 

Each port entry has the following format: 
Entry Word Description 

0 Port information 

[47: 1] = Port is reserved 

[46: 1] = In use 

[45: 1] = Dead 

[44: 1] = Out of service 

[43: 1] = Online 

[42: 1] = Unavailable 

[41: 4] = Subsystem protocol 

0 = SCSI maintenance bus (SMB) 

1 = Message level interface (MLI) 

2 = Intelligent peripheral interface (IPI) 

3 = Small-computer system interface (SCSI) 
[37:22] = Not used 

[15:16] = Port identification 

1 Port firmware word 1 
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Entry Word Description 

2 Port firmware word 2 

LINK [5] + 2 : Memory Information (A 16 Systems) 

This LINK has the following values: 
LINKTYPE 10 
LINKVERSION 2 
ITEM_COUNT 1 
ITEM_WIDTH 17 (words) 

The memory entry has the following format: 
Entry Word Description 

0 MSM MASK 

1 MSM 0 information 

[47: 4] Domain number associated with the MSM 
[43: 8] Mask of requestors connected to the MSM 
[35:20] (Reserved field) 
[15: 8] MSM status 

0 = Undefined 

1 = Ready 

2 = Saved 

3 = Unavailable 

[ 7: 7] MSM status subtype 

If Status field = 2 (saved) 

1 = Not in use 

2 = User saved 

3 = MCP inhibit 

If Status field = 3 (unavailable), this field is not used. 
Otherwise, this field stores a 0. 
[0: 1] Corrective action can be taken 

2 MSM 0 engineering release level (ERL) 
[47: 8] (Reserved field) 

[39: 4] Software compatibility level 
[35:12] Engineering release level cycle 
[23: 8] Engineering release level mark 
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( 

Entry Word Description v 

[15:16] (Reserved field) 

3 MSU 0 info and SYSTEM requestor mask 
[47: 8] SYSTEM 1 requestor mask 

[39: 8] SYSTEM 0 requestor mask 
[31: 8] (Reserved field) 
[23: 4] Model number of MSU 5 
[19: 4] Model number of MSU 4 
[15: 4] Model number of MSU 3 
[11: 4] Model number of MSU 2 
[ 7: 4] Model number of MSU 1 
[ 3: 4] Model number of MSU 0 
MSU model numbers 

1 = Old style SU, 8 megaword 
(probably type used during debug) 

2 = New style SU, 8 megawords per quadrant, 
maximum 32 megawords total 

4 MSM 0 MSU quadrant mask , 
[47:24] Present quadrant mask 



[47: 


1] 


MSU 


5 quadrant 


3 


[46: 


1] 


MSU 


5 quadrant 


2 


[45: 


13 


MSU 


5 quadrant 


1 


[44: 


1] 


MSU 


5 quadrant 


0 


[43: 


1] 


MSU 


4 quadrant 


3 



[28: 


1] 


MSU 


1 


quadrant 


0 


[27: 


1] 


MSU 


0 


quadrant 


3 


[26: 


1] 


MSU 


0 


quadrant 


2 


[25: 


1] 


MSU 


0 


quadrant 


1 


[24: 


1] 


MSU 


0 


quadrant 


0 



[23:24] In use quadrant mask 
[23: 1] MSU 5 quadrant 3 
[22: 1] MSU 5 quadrant 2 
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Entry Word Description 

[21: 1] MSU 5 quadrant 1 
[20: 1] MSU 5 quadrant 0 
[19: 1] MSU 4 quadrant 3 



[4: 1] MSU 1 quadrant 0 

[ 3: 1] MSU 0 quadrant 3 

[ 2: 1] MSU 0 quadrant 2 

[1:1] MSU 0 quadrant 1 

[0: 1] MSU 0 quadrant 0 

5 MSU 0 quadrant status 

Each model II MSUs can contain up to four 8 megaword quadrants. Since 
a model I MSU contains only 8 megawords, it is represented in this 
structure as having quadrant 0 present. All other quadrants are marked not 
present. 

Each of the four-bit quadrant status fields in words 5 and 1 1 has the 
following format: 

[3:1] Single-bit logging disabled 

[2:3] Status 

1 = Not in use 

2 = MCP inhibit 

The following are the quadrant status fields for each MSU. 



[47:16] MSU 2 










[47: 4] MSU 


2 


quadrant 


3 


status 


[43: 4] MSU 


2 


quadrant 


2 


status 


[39: 4] MSU 


2 


quadrant 


1 


status 


[35: 4] MSU 


2 


quadrant 


0 


status 


[31:16] MSU 1 










[31: 4] MSU 


1 


quadrant 


3 


status 


[27: 4] MSU 


1 


quadrant 


2 


status 


[23: 4] MSU 


1 


quadrant 


1 


status 


[19: 4] MSU 


1 


quadrant 


0 


status 


[15:16] MSU 0 










[15: 4] MSU 


0 


quadrant 


3 


status 
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Entry Word 



Description 



[11:4] MSU 0 quadrant 2 status 



[ 7: 4] MSU 0 quadrant 1 status 



[ 3: 4] MSU 0 quadrant 0 status 



6 



MSU 0 quadrant status, continued 



The comments for Word 5 also apply to these words. 



[47:16] MSU 5 






[47: 4] MSU 


5 quadrant 3 


status 


[43: 4] MSU 


5 quadrant 2 


status 


[39: 4] MSU 


5 quadrant 1 


status 


[35: 4] MSU 


5 quadrant 0 


status 


[31:16] MSU 4 






[31: 4] MSU 


4 quadrant 3 


status 


[27: 4] MSU 


4 quadrant 2 


status 


[23: 4] MSU 


4 quadrant 1 


status 


[19: 4] MSU 


4 quadrant 0 


status 


[15:16] MSU 3 






[15: 4] MSU 


3 quadrant 3 


status 


[11: 4] MSU 


3 quadrant 2 


status 



[ 7: 4] MSU 3 quadrant 1 status 
[3:4] MSU 3 quadrant 0 status 



[47:24] (Reserved field) 
[23:24] Quadrant mask 
For each bit in the quadrant mask, 

0 = Single-bit logging enabled 

1 = Single-bit logging disabled 

The following are the quadrants referred to by each bit: 
[23: 1] MSU 5 quadrant 3 
[22: 1] MSU 5 quadrant 2 
[21: 1] MSU 5 quadrant 1 
[20: 1] MSU 5 quadrant 0 



7 



MSM MSU single-bit logging disable mask 



continued 
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Entry Word Description 

[19: 1] MSU 4 quadrant 3 



[ 4: 1] MSU 1 quadrant 0 

[3: 1] MSU 0 quadrant 3 

[2: 1] MSU 0 quadrant 2 

[ 1: 1] MSU 0 quadrant 1 

[ 0: 1] MSU 0 quadrant 0 
8-13 MSU 1 information 

These words parallel the format of words 1 through 6. 
14 MSM 0 To-be-saved mask 

[47:24] (Reserved field) 
[23: 1] MSU 5 quadrant 3 
[22: 1] MSU 5 quadrant 2 
[21: 1] MSU 5 quadrant 1 
[20: 1] MSU 5 quadrant 0 
[19: 1] MSU 4 quadrant 3 

[ 4: 1] MSU 1 quadrant 0 
[ 3: 1] MSU 0 quadrant 3 
[2: 1] MSU 0 quadrant 2 
[ 1: 1] MSU 0 quadrant 1 
[0: 1] MSU 0 quadrant 0 
14 MSM 1 To-be-saved mask 

[47:24] (Reserved field) 
[23: 1] MSU 5 quadrant 3 
[22: 1] MSU 5 quadrant 2 
[21: 1] MSU 5 quadrant 1 
[20: 1] MSU 5 quadrant 0 

continued 
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Entry Word Description 

[19: 1] MSU 4 quadrant 3 

[4: 1]MSU 1 quadrant 0 
[ 3: 1] MSU 0 quadrant 3 
[2: 1] MSU 0 quadrant 2 
[ 1: 1] MSU 0 quadrant 1 
[ 0: 1] MSU 0 quadrant 0 

LINK [5] + 3 : Peripheral Information (A 16 Systems) 

This LINK has the same format as LINK [5] + 3 under "Link Descriptions for A 17 
Systems" in this section. 

LINK [5] + 4 : Extended Pack Information (A 16 Systems) 

This LINK has the same format as LINK [5] + 4 under "Link Descriptions for HDU 
Systems" in this section. 

LINK [5] + 5 : Path Group Information (A 16 Systems) 

This LINK has the same format as LINK [5] + 5 under "Link Descriptions for A 17 
Systems" in this section. 

LINK [5] + 7 : Task Control Processor Information (A 16 Systems) 

This LINK has the same format as LINK [5] + 7 under "Link Descriptions for A 17 
Systems" in this section. 
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LINK [5] + 8 : Domain Status Information (A 16 Systems) 

This LINK has the following values: 
LINKTYPE 30 
LINKVERSION 0 
ITEM_COUNT 1 
ITEM_WIDTH 10 (words) 

The domain entry has the following format: 
Entry Word Description 

0-7 Requestor status information 

[47: 16] Requestor type 

4'00' = Unknown module 

4'E1' = CPM 

4'E2' = IOM 

4*E3' = RMM 
[31: 8] Domain number requestor resides in 
[23: 8] Requestor number 
[15: 8] Requestor status 

0 = Undefined 

1 = Ready 

2 = saved 

3 = unavailable 
[7:7] Requestor status subtype 

If requestor status = saved 

1 = Not in use 

2 = User saved 

3 = MCP inhibit 

If requestor status = unavailable, field is not used 
Otherwise, this field stores a 0 

[ 0: 1] Corrective action can be taken 
8-9 MSM status information 

[47: 4] Domain number associated with the MSM 

[43: 8] Mask of requestors connected to the MSM 

[35:20] (Reserved field) 

[15: 8] MSM status 
0 = Undefined 
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continued 
Entry Word 



Description 

1 = Ready 

2 = Saved 

3 = Unavailable 

[ 7: 7] MSM status subtype 
If status = saved 

1 = Not in use 

2 = User saved 

3 = MCP inhibit 

If status = unavailable, this field is not used 
Otherwise, this field stores a 0 
[ 0: 1] Corrective action can be taken 



LINK [5] + 1 : Version 2 I/O Processor Information (IOM and RMM Systems) 

Note: The format of I/O information logged for IOM and RMM systems is 
changing in a future release. A program can determine which format 
is being used by inspecting the LINK_VERSION value, which will 
change from 0to2 when the format changes. The following pages 
describe the version 2 format of I/O processor information for IOM 
and RMM systems. 

Though the following description applies to both IOM and RMM 
systems, the IOM terminology is used throughout. For A 17 systems, 
references to IOMs should be interpreted as RMMs, and references to 
IOUs should be interpreted as IOPs. 

This LINK has the following values: 
LINKTYPE 21 
LINKVERSION 2 
ITEM_COUNT Number of IOMs 
ITEM WIDTH 5 (words) 

Each I/O processor entry has the following format: 
Entry Word Description 

0 IOM information 

[47: 8] IOM domain number 
[39:21] (Reserved field) 
[18: 8] IOM status 
0 = Freed 

continued 
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Entry Word Description 

1 = In use 

2 = Saved 

3 = Unavailable 
[10: 7] IOM status subtype 

If IOM Status field = 2 (saved): 

1 = Not in use 

2 = User saved 

3 = MCP inhibit 

If IOM Status field = 3 (unavailable): 

1 = Domain powered off 

2 = Module not present 

3 = Module uninitialized 

4 = CSD interface unavailable 

5 = CSD interface saved 

6 = Memory interface unit (MIU) failed to initialize. 

7 = Peripheral configuration diagrams (PCDs) do not match. 

8 = No peripheral configuration diagram (PCD) 

9 = No master clock 

10 = No REM in partition 
Otherwise, this field is not used. 

[ 3: 4] IOM requestor number 

1 (Reserved word) 

2 IOU LINK 

3 DTU LINK 

4 Port LINK 

The IOU LINK word has these values: 
LINK_TYPE 31 
LINK_VERSION 0 

ITEM_COUNT Number of lOUs in the IOM 
ITEM WIDTH 3 (words) 
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Each IOU entry has the following format: 
Entry Word Description 

0 IOU information 

[47: 1] = IOU is reserved. 
[46: 1] = In use 
[45: 1] = Dead 
[44: 1] = Out of service 
[43: 1] = Online 
[42: 1] = Unavailable 
[41: 1] = Distinguished 
[40: 1] = Inactive 
[39:201 = (Reserved field) 
[19:04] = IOM board number 
[15:16] = IOU number 

1 IOU firmware word 1 

2 IOU firmware word 2 

The DTU LINK word has these values: 
LINKTYPE 22 
LINKVERSION 2 

ITEM COUNT Number of DTUs on the IOM 
ITEM WIDTH 3 (words) 

Each DTU entry has the following format: 
Entry Word Description 

0 DTU information 

[47: 1] = DTU is reserved. 
[46: 1] = In use 
[45: 1] = Dead 
[44: 1] = Out of service 
[43: 1] = Online 
[42: 1] = Unavailable 
[41:22] = (Reserved field) 
[19:04] = IOM board number 
[15:16] = DTU identification 

1 DTU firmware word 1 

2 DTU firmware word 2 
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The port LINK word has these values: 
LINK_TYPE 23 
LINK_VERSION 2 

ITEM_COUNT Number of ports on the IOM 
ITEM_WIDTH 3 (words) 

Each port entry has the following format: 
Entry Word Description 

0 Port information 

[47: 1] = Port is reserved. 

[46: 1] = In use 

[45: 1] = Dead 

[44: 1] = Out of service 

[43: 1] = Online 

[42: 1] = Unavailable 

[41: 4] = Subsystem protocol 

0 = SCSI maintenance bus (SMB) 

1 = Message-level interface (M LI) 

2 = Intelligent peripheral interface (I PI) 

3 = Small-computer system interface (SCSI) 
[37:18] = (Reserved field) 

[19: 4] = IOM board number 
[15:16] = Port identification 

1 Port firmware word 1 

2 Port firmware word 2 
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This log entry uses LINKs to store information in a tree structure. One LINK is at the 
top of the tree; this LINK describes a region that contains eight LINKs. Each of these 
LINKs describes a region that contains information about the software configuration. 
In some cases, these regions contain LINKs to other regions. The fixed part of the 
software configuration log entry consists of the information in Table 12-31, "Major 
Type 2-Minor Type 18." 



Table 12-31. Major Type 2-Minor Type 18 


Minor Type = 


18 Software Configuration (SOFTWARECONFIG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


General information. This word has the same layout as Word 4 of the 
Hardware Configuration log entry. For a description of this word, refer to 
Table 12-30, "Major Type 2-Minor Type 17." 


5 


LINK to the software information 



All the actual software configuration information resides in the variable part of the 
software configuration entry. Accessing any of this information requires that the LINK 
at Word 5 be examined. For further information about the LINKs used in this log entry, 
refer to "Format of Hardware and Software Configuration LINK Words" earlier in this 
section. 

The LINK at Word 5 contains the following values: 
LINKTYPE 1 
LINKVERSION 0 
ITEM_COUNT 10 (LINKs) 
ITEM_WIDTH 1 

The region described by the LINK at Word 5 has the following format: 



Offset Contents LINKTYPE 

0 LINK to general MCP information 2 

1 LINK to support library information 3 
.2 LINK to disk location information 4 

3 LINK to substitute backup information 5 

4 LINK to ASD information. 6 



Prior to the Mark 3.9 system software release, this was 
a LINK to memory management parameter information 
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Offset 

5 

6 
7 



Contents 



Not used. 



Prior to Mark 3.9, this was a LINK to subsystem 
information 

LINK to queue information 
Not used. 

Prior to Mark 3.9, this was a LINK to SWAPPER 
parameter information 

LINK to SEGARRAY start information 
LINK to security information 



SUMLOG 

LINKTYPE 

7 

8 
9 



16 
18 



The values contained in each LINK in the preceding table and the format of the 
information corresponding to each LINK are given in the following paragraphs. 

All LINKs that describe an item in length-string form have the following values: 
LINKTYPE 254 
LINK_VERSION 0 
ITEM_COUNT 1 (name) 

ITEM_WIDTH Number of characters used to store this string 

All LINKs that describe a name in standard form have the following values: 
LINKTYPE 255 
LINKVERSION 0 
ITEM_COUNT 1 (name) 

ITEM WIDTH Number of characters used to store this name 



LINK [5] + 0 : General MCP Information 

This LINK has the following values: 
LINKTYPE 2 
LINKVERSION 1 
ITEM_COUNT 32 
ITEM WIDTH 0 (heterogeneous) 
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This region has the following format: 
Region Word Description 

0 LINK to halt/load and backup unit information (See "Halt/Load and Backup 
MCP Unit Information" following this table.) 

1 MCP version 
[47:16] MARK_LEVEL 
[31:16] CYCLE 
[15:16] PATCH_NUMBER 

2 MCP compilation date and time (timestamp) 
[47:16] Date (Julian - 700000) 

[35:32] Time (2 .4-microsecond increments) DIV 16 

3 MCP "compiled by" information 
[23: 8] MARK LEVEL (of compiler) 
[9:10] CYCLE (of compiler) 

4 System serial number 

5 LINK-to-MCP compile-time options 
LINKTYPE = 14 
LINKVERSION = 0 
ITEM_COUNT = 1 

ITEM WIDTH = Number of characters 

Each option is separated from the next by a null byte (48 "00"), and the list 
is terminated by two null bytes in succession. 

6 LINK to GROUP ID (length-string form) 

7 CATALOGLEVEL 

8 OPTIONS word 

The option numbers correspond to the bit numbers in this word. 

9 LINK to NIF name (standard form) 

10 LINK to CONFIGURATION FILE name (standard form) 

1 1 LINK to SUPERVISOR name (standard form) 

12 LINK to SYSTEM INTRINSICS name (standard form) 

13 System balancing parameters 
[ 0: 1] IDLE 

[ 1: 1] IOFINISH 
[2: 1] WAITING 
[ 3: 1] QUEUEEMPTY 

14 Compiler target 

continued 

12-144 8600 0478-100 



SUMLOG 



continued 
Region Word 



15 

16-18 
19 



20 
21 



22 



Description 

[13: 1] Level indicator 

[12: 8] If [13: 1] is 1, then field [12: 8] contains the target level. 
Otherwise, field [12: 8] contains the target machine ID. 

[ 4: 5] TARGET-CLASS 
1 = Level 0 
3 = Level 1 

Number of characters in SYSTEM LANGUAGE name 

SYSTEM LANGUAGE name 

Disk resource control (DRC) system status 

0 = Inactive 

1 = Will be started after the next halt/load 

2 = Initializing 

3 = Active 

4 = Terminating 

Number of predefined time zones 
Encoded time zone information word. 
[47: 1] Time zone configured 

0 = Time zone not configured. 

1 = Time zone is configured. 
[46: 1] Time zone offset direction 

0 = Local time is Universal Time (UT) - offset. 

1 = Local time is UT + offset. 
[45: 2] Not used 

[43: 1] Custom time zone 

0 = Predefined time zone. Words 22-28 are not valid. 

1 = Custom time zone. Words 22-28 store further information. 
[42: 3] If custom time zone, length of abbreviation (1-6) 

[39: 8] Hours offset (0-24) 

[31:8] Minutes offset (0-59) 

[23: 8] Military-style mnemonic (in EBCDIC) or zero 

[15:4] Not used 

[11:12] If predefined time zone, its number 

Custom time zone abbreviation (left-justified) Valid only if Word 21, [43: 1] 
= 1. 
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continued 

Region Word Description 

23-28 Custom time zone in substandard form Valid only if Word 2 1 , [43: 1] = 1 . 

29 LINK to hostname (in standard form) 

30 Current CCSVERSION 
[15:16] CCSVERSION number 

31 LINK to current CONVENTION (length-string form) 



Halt/Load and Backup MCP Unit Information 

This region is used to list each unit that is either a halt/load unit or an MCP backup 
unit, and the name of the MCP code file. 

The LINK to halt/load and backup MCP unit information has the following values: 



LINKTYPE 15 

LINK_VERSION 0 

ITEM_COUNT 1 

ITEMWIDTH 5 (words) 

Each entry in this region has the following format: 
Entry Word Description 

0 Device number 

1 Device number of BACKUP_UNIT_1 (not applicable if Word 3 is 0) 

2 Device number of BACKUPUNIT2 (not applicable if Word 3 is 0) 

3 Halt/load processor mask (bit SET for each processor that uses this unit as 
its halt/load unit) 

4 LINK to name of MCP on this unit (standard form) 

LINK [5] + 1 : Support Library Information 

This LINK has the following values: 
LINKTYPE 3 
LINKVERSION 0 
ITEM_COUNT Number of libraries 
ITEM WIDTH 4 (words) 
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Each entry in this region has the following format: 
Entry Word Description 

0-2 LIBRARYJD (function name, length-string form) 

3 LINK to library code file name (standard form) 

LINK [5] + 2 : Disk Location Information 

This LINK has the following format: 
LINKTYPE 4 
LINK_VERSION 0 
ITEM_COUIMT 10 
ITEM_WIDTH 1 (words) 

Each entry in this region has the following format: 



Entry Word 


Description 


0 


LINK to CATALOG family (length-string form) 


1 


LINK to JOBS family (length-string form) 


2 


LINK to USERDATA family (length-string form) 


3 


LINK to BACKUP family (length-string form) 


4 


LINK to LOG family (length-string form) 


5 


LINK to overlay family (length-string form) 


6 


LINK to extra overlay families 


7 


LINK to DP FILES family (length-string form) 


8 


LINK to SORT family (length-string form) 


9 


LINK to IPFILES family (length-string form) 



The LINK to extra overlay families has the following values: 
LINKTYPE 11 
LINKVERSION 0 

ITEM_COUNT Number of extra overlay families 
ITEM_WIDTH 4 (words) 
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Each entry has the following format: 
Entry Word Description 

0 This word stores a 0. 

On logs generated prior to the Mark 3.9 system software release, this word 
stores an ASN number. A value of 0 indicates global memory. Any other 
value indicates the local memory subsystem with the corresponding 
number. 

1-3 Overlay family (length-string form) 

LINK [5] + 3 : Substitute Backup Information 

This LINK has the following values: 
LINKTYPE 5 
LINKVERSION 0 
ITEM_COUNT 6 
ITEMWIDTH 1 (word) 

Each entry in this region has the following format: 

Entry Word Description 

0 SB information for DISK 

1 SB information for PACK 

2 SB information for TAPE 

3 SB information for PETAPE 

4 SB information for TAPE9 

5 SB information for TAPE7 

Each of the preceding six entry words has the following format: 



Field 


Meaning 


[47: 4] 


First device 


[43: 4] 


Second device 


[39: 4] 


Third device 


[35: 4] 


Fourth device 


[31: 4] 


Fifth device 


[27: 4] 


Sixth device 


[23: 4] 


Seventh device 


[19:20] 


Reserved 
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The devices are given the following code numbers: 



Device 



Number 


Device Type 


1 


DISK 


2 


PACK 


3 


TAPE 


4 


PETAPE 


5 


TAPE9 


6 


TAPE7 


7 


DLBACKUP 



LINK [5] + 4 : Memory Management Parameters 

This LINK has the following values: 
LINKTYPE 6 
LINKVERSION 1 
ITEM_COUNT 9 
ITEM_WIDTH 1 (word) 

Each entry in this region has the following format: 
Entry Word Description 

0 OLAYGOAL (percent) 

1 AVAILMIN (percent) 

2 FACTOR (percent) 

3 PRIORITY (percent) 

4 BUFFERGOAL. The absolute value of this word is the current 
BUFFERGOAL value. If the word contains a negative value, then the 
system is using the default BUFFERGOAL value. If the word contains a 
positive value, then the system is using a BUFFERGOAL value specified by 
the configuration file or by an SF (Set Factor) system command. 

5 Current ASD factor 

6 Next ASD factor 

7 Overlay saturation 

8 Overlay change 
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LINK [5] + 5 : Subsystem Information 

This LINK is no longer used. In system logs generated prior to the Mark 3.9 system 
software release, this LINK has the following values: 

LINKTYPE 7 

LINK_VERSION 0 

ITEM_COUNT Number of subsystems 

ITEM_WIDTH 4 (words) 

Each entry in this region has the following format: 
Entry Word Description 

0-2 Subsystem name, length-string 

3 Mask of ASNs that are in this subsystem 

0 = GLOBAL ASN 

1 = LOCAL 1 

2 = LOCAL 2 



LINK [5] + 6 : Queue Information This LINK has the following values: 

LINKTYPE 8 
LINKVERSION 0 
ITEM_COUNT 3 
ITEM_WIDTH 1 (words) 

Each entry in this region has the following format: 
Entry Word Description 

0 GLOBAL_MIXLIMIT 

1 DEFAULTQUEUE 

2 LINK to individual queue information 
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The LINK to the individual queue information region has the following values: 
LINKTYPE 12 
LINKVERSION 0 
ITEM_COUNT Number of queues 
ITEM_WIDTH 39 (words) 

Each entry for an individual queue has the following information. Note than an 
explicit value of 0 for an integer or real attribute is represented by 4'800000000000\ 
Because of this representation, you can determine whether an attribute has been set by 
comparing the word that describes that attribute with 0. 

Entry Word Description 

0 Queue number 

1 MIXLIMIT 

2 TASKLIMIT 

3 TURNAROUND (seconds) 

4 SUBSPACES (Not used on Mark 3.9 or later releases) 

5-7 Family to substitute for, in length-string form. For example, for a FAMILY 

statement of "DISK = MCPMAST OTHERWISE SYS33", these words store 
"DISK". 

8-10 Family to substitute, in length-string form. For example, for a FAMILY 

statement of "DISK = MCPMAST OTHERWISE SYS33", these words store 
"MCPMAST 1 . 

1 1-13 Alternate family to substitute, in length-string form. For example, for a 

FAMILY statement of "DISK = MCPMAST OTHERWISE SYS33", these 
words store "SYS33". 

14-16 SUBSYSTEM (length-string form). These words are not used on Mark 3.9 

or later releases. 

17 DEFAULT PRIORITY 

18 DEFAULT IOTIME (seconds) 

19 DEFAULT PROCESSTIME (seconds) 

20 DEFAULT LINES 

21 DEFAULT CARDS 

22 DEFAULT WAITLIMIT (seconds) 

23 DEFAULT DISKLIMIT (segments) 

24 DEFAULT ELAPSEDLIMIT (seconds) 

25 LIMIT PRIORITY 

26 LIMIT IOTIME (seconds) 

27 LIMIT PROCESSTIME (seconds) 

28 LIMIT LINES 
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continued 



Entry Word 


Description 


29 


LIMIT CARDS 


30 


LIMIT WAITLI MIT (seconds) 


31 


LIMIT DISKLI MIT (segments) 


32 


LIMIT ELAPSEDLIMIT (seconds) 


33 


Not used 


34 


LIMIT TAPE7 


35 


LIMIT TAPE9 


36 


LIMIT TAPEPE 


37 


DEFAULT SAVEMEMORYLIMIT 


38 


LIMIT SAVEMEMORYLIMIT 



LINK [5] + 7 : SWAPPER Parameters 

This LINK is no longer used. In system logs generated prior to the Mark 3.9 system 
software release, this LINK has the following values: 

LINKTYPE 9 

LINKVERSION 0 

ITEM_COUNT Number of boxes with SWAPPER parameters 

ITEM WIDTH 18 (words) 



Each entry in this region has the following format: 
Entry Word Description 



0 



ASN number 

0 = GLOBAL ASN 

1 = LOCAL 1 

2 = LOCAL 2 



SWAPPERSTATUS 

0 = NOT RUNNING 

1 = RUNNING 
CORESIZE (990-word slots) 
EXPMAXCORE (990-word slots) 
EXPRESSRESERVE (990-word slots) 
EXPMAXTIME (seconds) 

I OBI AS (percent) 
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Entry Word Description 

7 MAXCORE (990-word slots) 

8 MAXIOSIZE (990-word slots) 

9 MAXSLICENUMBER 

10 MEMORYBIAS (percent) 

1 1 MINCHUNKSIZE (990-word slots) 

12 Ml NTI M ESLICE (seconds) 

13 PRIORITYBIAS (percent) 

14 RATIO 

1 5 UTILjZATIONBIAS (percent) 

16 [47:47] Reserved 
[0: 1] 

0 = NOSWAPTRANSTATE 

1 = SWAPTRANSTATE 

17 LINK to SWAPPER family names used by the SWAPPER running in this 
ASN 

The LINK to the SWAPPER family names region has the following format: 
LINKTYPE 13 
LINK_VERSION 0 

ITEM_COUNT Number of SWAPPER families 
ITEM WIDTH 3 (words) 

Each entry in this region has the following format: 
Entry Word Description 

0-2 SWAPPER family name (length-string form) 

LINK [5] + 8 : SEGARRAYSTART Information 

This LINK has the following values: 

LINK_TYPE 16 

LINKVERSION 0 

ITEM_COUNT 2 

In system logs generated prior to the Mark 3.9 system software release, the 
ITEM COUNT equals the number of ASNs in the system + 1. 

ITEM WIDTH 1 (word) 
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Each entry in this region has the following format: 
Entry Word Description 

0 The maximum size of a LONG array that can be overlayed by the system. 
Used as a limit for the SEGARRAYSTART setting. 

1 SEGARRAYSTART value 

In system logs generated prior to the Mark 3.9 system software release, each entry in 
this region has the following format: 

Entry Word Description 

1 The maximum array size that can be overlayed by the system. Used as a 

limit for all the SEGARRAYSTART settings. 

2-x The setting for corresponding ASN (Word 1 = global, Word 2 = local 1, 

Word 3 = local 3, and so on) 

LINK [5] + 9 : Security Information 

This LINK has the following values: 
LINKTYPE 18 
LINKVERSION 0 
ITEM_COUNT 2 
ITEM WIDTH 0 (Heterogeneous) 

Each entry in this region has the following format: 
Region Word Description 

0 Security options word 

[00:01] Security administrator authorized 
[01:01] Program dump filtering 
[02:01] Mandatory disk scrubbing 
[03:01] Nonuser file security 

0 = PUBLIC 

1 = PRIVATE 
[04:01] Restrict all hosts 
[05:01] Usercoded backup 
[06:01] (Reserved) 
[07:01] Tape scrubbing 
[11:04] Security class 

0 = Class U (unspecified) 

1 = Class SO 

2 = Class SI 
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Region Word Description 

3 = Class S2 
[13:02] Current tape security 

0 = NONE 

1 = AUTOMATIC 

[1 5:02] Future tape security 
[18:03] Password management 

0 = MINIMAL 

1 = GENERATED 

[19: 1]S1 miscellaneous restrictions 
[20: 1] S2 miscellaneous restrictions 
[23:03] Reserved for future use 
[27:04] LOGONATTEMPTS value 
[30:03] LAISSEZFILE (CANDE) 
[31:01] Reserved for future use 
[32:01] DIALLOGIN (CANDE) 
[33:01] ALLLOGIN (CANDE) 
[34:01] SECDIALIN (CANDE) 
[35:01] SECPSEUDO (CANDE) 
[36:01] SECALL (CANDE) 
[37:01] USECOMSPRIV (CANDE) 
[46:09] Reserve for future use 
[47:01] InfoGuard authorized 

1 LINK to Log Options. This LINK has the following format: 

LINKTYPE = 17 
LINK_VERSION = 0 
ITEM_COUNT = 1 

ITEM_WIDTH = length of log options array in words 
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The following log entry can appear only in system logs generated prior to the Mark 3.9 
system software release. 



Table 12-32. Major Type 2-Minor Type 19 



Minor Type = 


19 Environment Configuration (ENV_CONFIG) [Extended memory systems only] 


Words 


Description 


US 


As described in Table 12-2, First Four Log Entry Words 


4 


Reason for log entry 




1 = Operator requested (result of operator entered EC) 




2 = System halt/loaded 


5-51: 


Information about ASNs 0 through 46 




[32: 1] = Split ASN 




[31: 1] = Code environment specified in the configuration file 




[30: 7] = Number of code pages 




[23: 1] = Data environment specified in the configuration file 




[22: 7] = Number of data pages 




[15: 8] = Code page mask 




[7: 8] = Data page mask 
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Words 5 through 31 are used if Word 4 = 0 (A Series EMS system single-bit error). 



Table 12-33. Major Type 2-Minor Type 20 



Minor Type = 20 Internal Processor Errors (PROCESSORERRORS) 
[A Series EMS systems only] 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


What kind of error 

[ 7: 8] = Processor error code 

u = a oeries lmo sysiem singie-uii error 

i ric reniaii luer oi vvoru *+ ib rcservcu lur luiure use, oiuy neiu i / . o\ biiuuiu 
be referenced. 


5 


General information 
[47: 1] = Reason 

0 = Error threshold 

1 = Hard correctable 

[34:35] = Sampling period duration (2.4-microsecond units) 


6 


General information 
[47:24] = Sample count 
[23:24] = Number of error words 


7-30 


Reserved for configuration expansion 


31-end 


Error words 

Single-bit error log with processor number in [47: 3] 
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Table 12-34. Major Type 2-Minor Type 21 



Minor Type = 211/0 Exception (MLIOEXCEPTION) 
Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

Normal I/O Exceptions: 

4 MLAOVERALLVERSION; overall log entry version, currently 0 (zero) 

5 M LAG EN I N FOD ESC; LINK to general information area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words 
[15:16] Word index to the area 

6 MLASTATINFODESC; LINK to statistical information area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words 
[15:16] Word index to the area 

7 MLAIORECORDDESC; LINK to I/O record area 
[47:16] Version; currently 0 (zero) 
[31:16] Area size in words 

[1 5:16] Word index to the area 

8 MLACRAREADESC; LINK to command/result area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words 
[1 5:16] Word index to the area 

9 MLAXSTATUSDESC; LINK to extended status area 
[47:16] Version currently 0 (zero) 

[31:16] Area size in words 
[1 5:16] Word index to the area 

10 MLAFILEINFODESC; LINK to file information area 

continued 
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Table 12-34. Major Type 2-Minor Type 21 (cont.) 



Minor Type = 


21 I/O Exception (MLIOEXCEPTION) 


Words 


Description 




[47:16] Version; currently 0 (zero) 




[31:16] Area size in words 




[15:16] Word index to the area 


11 


MLAJOBINFODESC; LINK to job information area 




[47:16] Version; currently 0 (zero) 




[31:16] Area size in words 




[15:16] Word index to the area 


12-end 


Variable-length information 



The following text contains variable-length information as described previously. 



Normal I/O Exceptions: General Information Area 

The general information area referenced by Word 5 has the following format: 
Word Description 
0 Control information 

[47: 8] MLALOGSTATUS 

0 = MLANOTSETUP 

1 = MLANORMAL 

2 = MLAXSTATUSONLY 

3 = MLAINLINE (for EMS systems only) 

4 = MLAERRORIOCB (for EMS systems only) 
[39: 4] MLANUMFILEITEMS 

Number of items of file information logged. File information includes the file 
title, the internal name, and/or the serial number. 

[35:20] Reserved 

[15: 8] MLAIOPROTOCOL 

0 = Intelligent peripheral interface (IPI) protocol 

1 = Message level interface (MLI) protocol 

continued 
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continued 



Word 



Description 



2 = SCSI protocol 
[ 7: 8] MLASYSTEMTYPE 

For a list of the possible values, refer to the description Word 3, field 
[15:16] in Table 12-66, "Major Type 10-AII Minor Types." 



[47:12] MLACTLTYPE; the control type 

4'58' = 9399-H control 

4'EO' = Native SCSI disk 
[35: 8] MLALUTYPE; logical unit type 
[27:12] MLAUNITSUBTYPE; standard unit subtype 
[15:16] MLALU; logical unit number 



[47: 1] M LAIR RECOVERABLE 

0 = The I/O was recovered. 

1 = The I/O could not be recovered. 
[46: 1] MLARETRYMASKEDOUT 

0 = Exception was not masked by user. 

1 = Exception was masked by user. 
[45: 1] MLAMISSINGRDS 

0 = All retries are logged. 

1 = One or more retries were lost due to logging limitations. The last 
retry logged is the final retry. There are retries missing between the last one 
logged and the one preceding it. 

[44: 5] MLARETRYENTRYSIZE; size of each retry entry in words 
[39: 4] MLAXSTATUSCONTROL 

0 = MLANOXSTATUS; no extended status (error log) information is 
present 

1 = MLAGOODXSTATUS; extended status (error log) information is 
present 

2 = MLABADXSTATUS; an error occurred while attempting to obtain 
extended status (error log) 

3 = MLACOULDNOTLOGXSTATUS; no error occurred, but the 
extended status data could not be logged. 

[35:12] Unused 



1 



Device-specific information 



2 



I/O retry and extended status control information 



continued 
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continued 

Word Description 

[23:12] MLAXSTATUSAREASIZE; number of bytes of extended status 
information 

[11: 3]MLAIOPTYPE 

1 = EMS 

2 = RMM 
4 = HDU 

[ 8: 9] MLANUMRETRIES; the number of retries 

Words 3 through 8 of the general information area contain information from the 
original I/O. Their format is as follows. More information is located in entry 0 (zero) of 
the I/O record area. 



Word Description 

3 MLAIOCW; software IOCW 

4 MLAEXTU; external unit number of the unit that incurred the exception 

5 MLABASEADDR; the base address of the I/O buffer 

6 Stack numbers 

[47:24] MLAOWNERSTKNO; owner stack number 
I [23:24] MLAINITSTKNO; initiating stack number 

7 I/O length and stack numbers 
[47:14] MLAJOBNUM 
[33:14] MLATSKNUM 



[19:20] MLAIOUNiTS; I/O length in either characters or words depending 
on the value in MLACW 

8 MLASTIME; a 36-bit integer in units of 2.4 microseconds indicating the 
time of day when the MCP received the completed I/O 

9 MLAFULLLRD; logical result descriptor 

Normal I/O Exceptions: Statistics Area 

The statistics area referenced by Word 6 has the following format: 
Word Description 

0 Count of read and write operations for the logical unit 

[47:24] MLASTATREADERRORCOUNT; total read I/O operations to this 
unit since last halt/load 

[23:24] MLASTATWRITEERRORCOU NT; total write I/O operations to this 
unit since last halt/load 

continued 
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continued 

Word Description 

1 Count of I/O errors for the logical unit 

[47:24] HLAIOSTATREADF; total read error to this unit since last halt/load 

[23:24] HLAIOSTATWRITEF; total write errors to this unit since last 
halt/load 

2 Count of bytes transferred to or from the unit since the last halt/load 

3 Count of errors successfully recovered by the hardware since the last 
halt/load (currently not available for RMM systems). 

[47:24] MLASTATREADRECS; total read errors recovered by hardware 
since the last halt/load 

[47:24] MLASTATWR ITER ECS; total write errors recovered by hardware 
since the last halt/load 

Normal I/O Exceptions: I/O Record Area 

The I/O record area referenced by Word 7 contains a number of entries: one entry 
describing the original I/O plus one entry for each logged retry. The format of one entry 
in the I/O record area is described here. The number of retries is found in the general 
information area in the MLANUMRETRIES word. The size of each I/O record entry is 
found in the general information area in the MLAEETRYENTRYSIZE word. 

Word Description 

0 MLACW; hardware control word from the IOCB. 
[11: 1] word mode 

0 = I/O lengths are in terms of characters 

1 = I/O lengths are in terms of words 

1 LINK to the command packet contained in the command/result area. For 
intelligent peripheral interface (IPI) devices, the command length includes 
the length bytes themselves. For a log status of MLAINLINE, only the 
command LINK for the original I/O is included; all retry command LINKs 
are zero. 

[47:16] Unused 

[47: 2] MLAPOLLDEVICETYPE; 

0 = Not a polling command 

1 = Poll for not ready 

2 = Poll for ready 

[31:16] MLACOMMANDLENGTH; command length in bytes 

continued 

I 
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continued 

Word Description 



[15:16] MLACOMMANDOFFSET; word offset of command in 
command/result area 

MLAPATHINFOl; initiating path address for EMS and HDL) systems and 
external device numbers of the initiating path for RMM machines in the 
following format: 

[47:16] External device number of port 
[31:16] External device number of control 
[15:16] External device number of unit 

MLAPATHINF02; completing path address for EMS systems. For RMM 
systems, the external device numbers for the completing path and for HDU 
systems, the external device numbers of the initiating path in the following 
format: 

[47:16] External device number of port 
[31:16] External device number of control 
[15:16] External device number of unit 

MLAIORD; hardware result word. 

LINK to the response packet contained in the command/result area. The 
result length bytes for intelligent peripheral interface (IPI) results are not 
stored in the command/result area; therefore, the result length for these 
devices does not include the length bytes. 

[47:16] Unused 

[31:16] MLARESULTLENGTH; result length in bytes 

[15:16] MLARESULTOFFSET; word offset of result in command/result area 

Logical RD, the XLRD exception ID, and the "actual retry" bit. 
[47: 1] MLAACTUALRETRY 
[46: 1] MLAAUTOSENSE 

0 = System software is expected to issue a request sense I/O on 
receipt of a check condition status result. 

1 = The hardware is expected to issue a request sense I/O on receipt of 
a check condition status result. 

[45: 1] MLAFIXEDBLOCKIO 

0 = Not a fixed block data transfer I/O 

1 = Fixed block data transfer I/O 

continued 
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continued 



Word 



Description 



[44: 1] MLAROLLYOUROWN 



0 = The command was generated by System Software. 



1 = The command was generated by hardware. 



[43:16] MLAEXCEPTIONID 



[27:11] Unused 



[16:17] MLALRD 



7 



MLAMISCINFOl; system dependent information 



Normal I/O Exceptions: Command and Result Area 

Commands and results for each I/O record or retry are in this area. The I/O record area 
contains LINKs pointing to each command or result stored in this area. Word 1 of each 
I/O record area entry is a LINK to the corresponding command in the command and 
result area. Word 5 of each I/O record area entry is a LINK to the corresponding result 
in the command and result area. 

Results for SCSI I/O protocol devices are logged in different formats depending on 
the MLAAUTOSENSE bit, indicated in Word 6 field [46: 1] of the I/O record area. 
The MLAAUTOSENSE bit set indicates the hardware performs the request sense on 
receipt of a check condition status (= 4'02'); the information stored in the command 
and result area includes the original status byte (4'02') followed by the request sense 
operation status byte (4'00') followed by up to 28 bytes of request sense data. 

Original Req. Sense Req. Sense 

Status Status Data 



| 02 | 00 | <up to 28 bytes of data>| 



The MLAAUTOSENSE bit reset indicates the software issues the request sense 
operation when a check condition status (4'02') is returned. The I/Os are then logged 
as two separate I/Os. The retried original I/O result consists of only its status byte 
(4'02') 5 and the actual retry bit MLAACTUALRETRY (indicated in word 6 field [47: 1] 
of the I/O record area) is set to TRUE. The request sense I/O result contains its status 
byte (4' 00') followed by the request sense data for as many as 255 bytes, and its actual 
retry bit is set to FALSE. 

Note If the original status is not check condition (that is, not 4'02'), then 
a request sense operation is not performed, either by software or 
hardware, and the result contains only the original status. If the 
request rense I/O does not complete successfully (that is, the request 
sense status is not 4'00'), the data does not follow the request sense 
status byte. 
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The following ALGOL example demonstrates how to access the retry commands and 
results stored in the command and result area. In this example, LOGBUF is the array 
into which the log record has been read, RETRYNUM is an integer variable, and P is a 
pointer to a print buffer. 

DEFINE % PARTIAL LAYOUT OF 10 ERROR LOG RECORDS 



MLAGENINFODESCV = 5 #, % GENERAL AREA 

MLAGENINFOAREALOC (LA) = LA [MLAGENINFODESCV] . [15: 16] #, 
MLARETRYENTRYSIZE (LA) = (LA [MLAGENINFOAREALOC (LA) +2] 

.[44: 5]) #, 

MLANUMRETRIES (LA) = (LA [MLAGENINFOAREALOC (LA) +2] 

.[ 8: 9]) #, 

MLAIORECORDDESCV = 7 #, % 10 RECORD AREA 

MLAIORECORDAREALOC (LA) = LA [MLAIORECORDDESCV] . [15 : 16] #, 

MLACRAREADESCV = 8 #, % 10 COMMAND & RESULT AREA 

MLACRAREALOC (LA) = LA [MLACRAREADESCV] . [15: 16] #, 



MLACOMMAND LENGTH (LA,N)= 
MLACOMMANDOFFSET (LA,N)= 

MLACOMMAND (LA,N) 
MLARESULTLENGTH (LA,N) = 

MLARESULTOFFSET (LA,N) 

MLARESULT (LA, N) 



(LA [MLAIORECORDAREALOC (LA) 

+ MLARETRYENTRYSIZE (LA) *(N)+1] 
.[31:16]) #, 
LA [MLAIORECORDAREALOC (LA) 

+ MLARETRYENTRYSIZE (LA) * (N) +1] 
.[15:16] #, 

LA [MLACRAREALOC (LA) 

+ MLACOMMANDOFFSET (LA,N)] #, 
(LA [MLAIORECORDAREALOC (LA) 

+ MLARETRYENTRYSIZE (LA)*(N)+5] 
.[31:16]) #, 
= LA [MLAIORECORDAREALOC (LA) 

+ MLARETRYENTRYSIZE (LA) * (N)+5] 
.[15:16] #, 
= LA [MLACRAREALOC (LA) 

+ MLARESULTOFFSET (LA,N)] #; 
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( 

FOR RETRYNUM := 0 STEP 1 UNTIL MLANUMRETRIES (LOGBUF) - 1 DO 
BEGIN 

REPLACE P BY "RETRY NUMBER ", RETRYNUM FOR 2 DIGITS, 
", COMMAND ", 

POINTER (MLACOMMAND (LOGBUF, RETRYNUM), 4) 
FOR 2 * MLACOMMANDLENGTH (LOGBUF, RETRYNUM) 
WITH HEXTOEBCDIC, 
", RESULT ", 

POINTER (MLARESULT (LOGBUF, RETRYNUM), 4) 
FOR 2 * MLARESULTLENGTH (LOGBUF, RETRYNUM) 
WITH HEXTOEBCDIC; 

% % % print output buffer and then clear it with blanks 

END; 



Normal I/O Exceptions: Extended Status Area 

The extended status area referred to by Word 9 contains the number of bytes of 
extended status information specified by the MLAXSTATUSAREASIZE field (field 
[23:12] of Word 2). 

Native SCSI devices have no extended status data logged in this area. The request 
sense information is logged with each I/O as it is encountered. 

Normal I/O Exceptions: File and Job Information Areas 

The number of file information items is variable, specified by MLANUMFILEITEMS. 
There is only one item of job information. The first word of each item specifies the type 
and length of the item. The following table shows the format of each item: 

Word Description 

0 Item descriptor 

[39:20] length of item (including this word) 
[19:20] TYPE of item 

2 = Item is FILE TITLE information 

3 = Item is JOB NAME information 

If field [19:20] of Word 0 is 2 (FILE TITLE), then Words 1-end have the following format: 

1 Area number of the file on pack or disk. This word is all ones if no valid 
row index is present or if the unit is not a pack or disk. 

2-end If the length of the FILE TITLE item is greater than two, the rest of the item 

is the file title in standard form. 

If field [19:20] of Word 0 is 3 (JOB NAME), then Words 1-end have the following format: 
1-end The job name in standard form 
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Error IOCBs 

Error IOCBs are completed by the IOP on EMS systems when the error detected by the 
IOP is not associated with any particular I/O request. 

Error IOCBs are logged in formats similar to those shown in Table 12-34, "Major 
Type 2-Minor Type 21," except that certain words are not used. A brief overview of the 
information present in these words follows: 



Word Description 

4 MLAOVERALLVERSIONV; overall log entry version, currently 0 (zero). 

5 M LAG EN I N FOD ESCV; LINK to general information area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words; 1 for Error IOCB information 
[15:16] Word index into area 

6 MLASTATINFODESCV; statistical information is not present. 

7 MLAIORECORDDESCV; I/O record area is not present. 

8 MLACRAREADESCV; command and result information is not present. 

9 MLAXSTATUSDESCV; LINK to error IOCB extended status area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words 
[15:16] Word index into area 

10 MLAFILEINFODESCV; file information is not present. 

1 1 MLAJOBINFODESCV; job information is not present. 
12-end Variable-length information. 



Following are the variable-length areas described by the LINKs in the error IOCB log 
entry. 

Error IOCBs: General Information Area 

The general information area described by the LINK at Word 5 has the following 
format: 

Word Description 

0 Control Information 

[47: 8] MLALOGSTATUS 
4 = MLAERRORIOCB 
[39: 4] 0 
[35:12] 0 

[23: 8] MLAEINUMTAGWORDS; number of words of information in the 
DLP result area of the error IOCB. 

continued 
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continued 

Word Description 

[15: 8] MLAIOPROTOCOL 

1 = MLI protocol 
[ 7: 8] MLASYSTEMTYPE 

1 = A 2 

2 = A6 

5 = A 3 

6 = A9 

9 = A 10 

10 = A 5 
16 = A 1 

19 = A4 

20 = Micro A 

Error IOCBs: Extended Status Area 

This section contains the DLP result area described by the link at word 9 of the error 
IOCB. Each DLP result area word is stored as 52 bits of information starting at Word 0 
of this area. Figure 12-2 shows the general format of this area. 

Area Word 0 Area Word 1 



DLP result 


DLP result 


DLP result 


DLP result 




Word 0 Tag 


Word 0 


Word 1 Tag 


Word 1 




(4 bits) 


(48 bits) 


(4 bits) 


(48 bits) 





Figure 12-2. DLP Result Format for Error IOCBs 



Refer to individual system reference manuals for a more detailed description of the 
information returned in these words. Note that the whole error IOCB is not returned. 

Unassociated I/O Exceptions 

The intelligent peripheral interface (IPI) response packet might indicate a request to 
read the error log for some reason not associated with the command that was issued. 
Therefore, much of the information found in a normal I/O exception log entry might be 
0 (zero) in an unassociated I/O log entry. 

Unassociated errors are logged in formats similar to those shown in Table 12-34, 
"Major Type 2-Minor Type 21," except that certain words are not used. A brief 
overview of the information present in these words follows: 

Word Description 

4 MLAOVERALLVERSIONV; overall log entry version, currently 0 (zero). 

continued 
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continued 

Word Description 

5 MLAGENINFODESCV; LINK to general information area 
[47.16] Version; currently 0 (zero) 

[31:16] Area size in words 
[15:16] Word index to the area 

6 M LASTATI NFODESCV; statistical information is not present. 

7 MLAIORECORDDESCV; LINK to I/O record area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words 
[15:16] Word index to the area 

8 MLACRAREADESCV; command and result information is not present. 

9 MLAXSTATUSDESCV; LINK to extended status area 
[47:16] Version; currently 0 (zero) 

[31:16] Area size in words 
[15:16] Word index to the area 

10 MLAFI LEI NFODESCV; file information is not present. 

1 1 MLAJOBINFODESCV; job information is not present. 
12-end Variable-length information. 

The following text contains variable-length information as described previously. 

Unassociated I/O Exceptions: General Information Area 

The general information area described by the LINK at Word 5 has the following 
format: 

Word Description 

0 Control information 

[47: 8] MLALOGSTATUS 

2 = MLAXSTATUSONLY 
[39: 4] 0 
[35:20] 0 

[15: 8] MLAIOPROTOCOL 

0 = Intelligent peripheral interface (I PI) 
[ 7: 8] MLASYSTEMTYPE 

continued 
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continued 
Word 



Description 

17 = A17 

Device-specific information 

[47:12] MLACTLTYPE; the control type 

4'58' = 9399-H control 

[35: 8] MLALUTYPE; logical unit type or 0 

[27:12] MLAUNITSUBTYPE; standard unit subtype or 0 

[15:16] MLALU; logical unit number or 0 

I/O retry and extended status control information 
[47: 1]0 
[46: 1] 0 
[45: 1] 0 
[44: 5] 0 

[39: 4] MLAXSTATUSCONTROL 

1 = MLAGOODXSTATUS; extended status (error log) information is 
present. 

2 = MLABADXSTATUS; an error occurred while attempting to obtain 
extended status (error log). 

[35:12] 0 

[23:12] MLAXSTATUSAREASIZE; number of bytes of extended status 
information. 

[11: 3]0 

[8: 9]0 



MLAIOCW 
0 

MLAEXTU; external unit number of the unit that incurred the exception or 0 
(zero). 

MLABASEADDR 
0 

Stack numbers 
0 

I/O Length and stack numbers 
0 

MLASTIME; a 36-bit integer that indicates time of day in units of 2.4 
microseconds. 



continued 
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continued 

Word Description 

9 MLAFULLRD 
0 

Unassociated I/O Exceptions: I/O Record Area 

The I/O record area described by the link at Word 7 has the following format. Only one 
entry is described. 

Word Description 

0 MCLACW 
0 

1 Command packet information 
0 

2 MLAINITPATH 
0 

3 MLACOMPPATH; completing path information 
[47:16] External device number of port 
[31:16] External device number of control 
[15:16] External device number of unit 

4 MLALIORD 
0 

5 Result packet information 
0 

6 [47: 1] MLAACTUALRETRY =1 
[46: 3] 0 

[43:16] MLAEXCEPTIONID 
[27:11] 0 

[16:17] MLALRD = 0 

7 MLAMISCINFO 
0 

Unassociated I/O Exceptions: Extended Status Area 

The extended status area described by the LINK at Word 9 has the following format: 
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Table 12-35. Major Type 2-Minor Type 22 



Minor Type = 


22 Unit I/O Counts (UNITCOUNTS) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Entry information 




[47: 1] Unit counts cleared 




0 = Subtotal record; unit counts intact 




1 = Totals record; unit counts initialized 




[46: 3] Reason for logging counts 




0 = Hourly record 




1 = Log being transferred 




2 = Prior to a scheduled power off 




3 = Prior to changing the MCP 




[43:16] Number of units with counter entries 




[27: 8] LINK to unit entry information 


5 


Time elapsed since halt/load or last counter initialization 


The following text contains unit entries of five words each. The number of unit entries (Word 4) 


that are logged is variable, so this section is of variable length. These words contain values since 


the last halt/load or since the counter was initialized. The format of each entry is as follows: 


Entry Word 0 


Unit ID and bytes transferred 




[47:12] Physical unit number 




[35: 6] Logical unit type 




[29:30] I/O transfer volume in units of 1000 bytes 


Entry Word 1 


External device number 


Entry Word 2 


I/O counts (word 1) 




[47:24] Read I/O operations 




[23:24] Write I/O operations 


Entry Word 3 


I/O counts (word 2) 




[47:24] Read I/O errors 
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Table 12-35. Major Type 2-Minor Type 22 (cont.) 



Minor Type = 


22 Unit I/O Counts (UNITCOUNTS) 


Words 


Description 




[23:24] Write I/O errors 


Entry Word 4 


I/O counts (word 3) 




[47:24] Read I/O errors successfully recovered by the controller 




[23:24] Write I/O errors successfully recovered by the controller 


Table 12-36. Major Type 2-Minor Type 23 


Minor Type = 


23 Mainframe Hardware Report (MLMFHWREPORT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


MCP version 




[47:16] MARKLEVEL 




[31:16] CYCLE 




[15:16] PATCH_NUMBER 


5 


Time mainframe event occurred 


6 


Mainframe configuration information 




[47: 8] System type 




21 = A 16 




[39: 8] (Field reserved for future use) 




[31: 8]CPM mask 




[23: 8] I/O processor mask 




[15: 8] Memory mask 




[ 7: 4] Distinguished IOU 




[3:4] Distinguished TCU 
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Table 12-36. Major Type 2-Minor Type 23 (cont.) 



Minor Type 


= 23 Mainframe Hardware Report (MLMFHWREPORT) 


Words 


Description 


7 


System serial number 


q q 

o — zj 


(\klf\rr\c rocorA/prl fnrfntiiro iico^ 


10 


Report entry information 




[47:40] (Field reserved for future use) 




[ 7: 8] Type of entry 




1 = A 16 CPM interrupt 




2 = A 16 IOM report 




3 = A 16 report via console 


11-end 


Variable data, depending on the value reported in the type of entry field 




[ 7: 8] of Word 10. 
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Major Type = 3 String Entry (LOGMAJSTR) 



Table 12-37. Major Type 3-Minor Types 1 through 9 


Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 RSVP Message Entry (RSVP) 

2 Fatal Error Message Entry (FATAL) 

3 Nonfatal Error Message Entry (NONFATAL) 

4 System Message Entry (SYSTEM) 

5 Unit Message Entry (UNIT) 

6 Directory Message Entry (DIRECTORY) 

7 Display Message Entry (DISPLAY) 

8 Status Message Entry (STATUS) 

9 Unit RSVP Message Entry (UNITRSVP) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Number of bytes in string 


5-end 


Character string, in EBCDIC characters 
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Major Type = 4 MCS Entry (LOGMAJMCS) 



Table 12-38. Major Type 4-Minor Type 1 



Minor Type = 


1 Log-On Entry (MCSLOGON) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


A 


Log-on priority iniormauon 


5 


Sign-on class 




0 = Unswitched 




1 = New log-on 




2 = HELLO 




3 = New charge code 




4 = SPLIT (Session number change) 




5 = New access code 


6 


LINK to station name 


7 


LINK to usercode 


8 


LINK to chargecode 


9 


Represents the time of day when last connected. If log-on is a new connect 




and the word is valid, bit 47 is on. 


10 


Originator information 




[47: 1] Privileged user (if result indicator = relevant) 




[46: 1] Security administrator (if result indicator = relevant) 




[23: 8] MCS number 




[15:16] LSN 


11 


LINK to access code 


12 


LINK to privilege information 


13-end 


Variable-length data pointed to by the LINKs in this entry. 
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Table 12-39. Major Type 4-Minor Type 2 



Minor Tvnp = 

■Till IWI | T pC 


2 Loe-off Entrv (MCSLOGOFF) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Log-off priority information 


5 


Log-off class 


6 


LINK to station name 


7 


LINK to user code 


8 


LINK to chargecode 


9 


Not used 


10 


Originator information 
[23: 8] MCS number 
[15:16] LSN 


11 


Processor time 


12 


I/O time 


13 


Number of lines printed 


14 


Number of cards read 


15 


Number of cards punched 


16-17 


Not used 


18 


Termination condition 

0-199 = Unknown termination condition 

200 = Normal log off 

201 = MCS forced to EOJ (QUITted) 

202 = NSP died 

203 = Disconnected 

204 = New log-on sequence required (Log-on status changed by 
system operator) 

205 = Station cleared by operator or program 

206 = Station released to another MCS 


continued 
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Table 12-39. Major Type 4-Minor Type 2 (cont.) 



Minor Type = 


2 Log-off Entry (MCSLOGOFF) 


Words 


np<rrintion 




207 = Error abort 




208 = MCS restart 




209 = Change of charge code 




?1f) — ^p^inn nnmhpr rphirnpri 




211 = Split Session 




212 = Log off by HELLO 




213 = New access code 




214 = Log off because a station was detached (for example, because of 
a 7CL0SE command or because the MCS terminated) 




215 = Reserved for expansion 




216 = Security cleared 


19-22 


Not used 


23 


Session elapsed time (since log-on, split, or hello) 


24 


LINK to access code 


25-end 


Variable-length data pointed to by the LINKs in this entry 


Table 12-40. Major Type 4-Minor Type 3 


Minor Type = 


3 RJE Control Card Entry (MCSRJECC) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Length of control card image (in units of characters) 


5-end 


Control card image as a string of EBCDIC characters 
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Table 12-41. Major Type 4-Minor Type 4 


Minor Type 


= 4 MCS Message Entry (MCSMESSAGE) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Length of message (in units of characters) 


5-end 


MCS message as a string of EBCDIC characters 



The system logs a Major Type 4, Minor Type 5 (MCSACCRUAL) entry when it is 
necessary to record the resource usage of an MCS session before the session ends. For 
example, the system issues this log entry if the user changes the charge code during a 
session. 



Table 12-42. Major Type 4-Minor Type 5 


Minor Type = 


5 Session Accrual Entry (MCSACCRUAL) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4-end 


As described in Table 12-39, "Major Type 4-Minor Type 2," except that the 
termination condition word (Word 18) is not used in an MCSACCRUAL 
entry. 
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Table 12-43. Major Type 4-Minor Type 6 



Minor Type 


= 6 MCS Security Violation Entry (MCSSECURITY) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Error information 




[34: 1] Line was disconnected 




[33: 1] Station was saved 




[32: 1] Station was cleared (and logged off if necessary) 




[31:16] Installation-determined error code 




Lib:loj MLb error code 




0 = Installation-detected error at log-on 




± — IMbldlldilun-UclcClcU tJfiUi dl (-NdigcoUUc Llldllgc 




c. — INbldlldllUII-UeleLlcU cI[UI dl dUUebbUUUc Ul Idl Igc 




3 = Invalid usercode/password at log-on 




4 = Invalid chargecode at log-on 




5 = Invalid accesscode/password at log-on 




6 = Invalid station name at log-on (RJE only) 




7 = Invalid chargecode while changing chargecodes 




8 = Invalid accesscode while changing accesscodes 




9 = Invalid old password while changing password of usercode 




10 = Invalid old password while changing password of accesscode 




11 = Attempted to access unauthorized COMS window 




12 = Attempted to log on from an MCS other than COMS with a 




usercode for which COMSONLYLOGON is TRUE 




13 = NODEFAULTUSE set for usercode 




14 = Log on attempts exceeded, station saved 




15 = Log on attempts exceeded, station saved and disconnected 


5 


Identification 




[39:16] Session number if already logged on 


continued 
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Table 12-43. Major Type 4-Minor Type 6 (cont.) 



Minor Type = 


6 MCS Security Violation Entry (MCSSECURITY) 


Words 


Description 




[23: 8] MCS number 




[15:16] LSN 


6 


LINK to station identifier 


7 


LINK to usercode 


8 


LINK to chargecode 


9 


LINK to accesscode 

The usercode, chargecode, or accesscode is supplied only if it has already 
been successfully validated. For example, if the usercode/password failed 
validation on a new log on, words 7, 8, and 9 would be all zeros. The old 
chargecode or accesscode is supplied in error codes 1,2,7, and 8. In the 
case of error code 6, which is detected only by RJE with the STATION ID 
option set, the station identifier is the default station for that line. 


10 


LINK to input string that failed validation 


11-end 


Variable-length data pointed to by the LINKs in this entry 


Table 12-44. Major Type 4-Minor Type 7 


Minor Type = 


7 MCS Station Application (LOGMI N_STATAPPLV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Type 

0 = CANDE log station 


5 


Event 

0 = Attach station 



continued 
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Table 12-44. Major Type 4-Minor Type 7 (cont.) 



Minor Type = 7 MCS Station Application (LOGMI N_STATAPPLV) 
Words Description 

1 = Change station application 

2 = Detach station 

6 LINK to originating station name 

7 LINK to destination station name 

8 LINK to originating usercode 

9 LINK to destination usercode 

10 Elapsed time attached 

1 1 Identification 

[39: 8] MCS number 
[31:16] Destination LSN 
[15:16] Origination LSN 

12 Miscellaneous information; if Type = 0 (CANDE log station) then 



[13: 1] = 


LGLOGSTA 


[12: 1] = 


AUTOINFO 


[11: 1] = 


LG FAULT 


[10: 1] = 


LGSABORT 


[9: 1] = 


LGUNABLE 


[8: 1] = 


LGSPO 


[7: 1] = 


LGSECURE 


[ 6: 1] = 


LGEOT 


[5: 1] = 


LGBOT 


[4: 1] = 


LGERROR 


[3: 1] = 


LGCHARGE 


[2: 1] = 


LGOFF 


[1:1] = 


LGON 


[0:1] = 


LGATTACH 



continued 



12-182 



8600 0478-100 



SUMLOG 



Table 12-44. Major Type 4-Minor Type 7 (cont.) 



Minor Type = 


7 MCS Station Application (LOGMI N STATAPPLV) 




Words 


Description 




13-end 


Variable-length data pointed to by the LINKs in this entry 




Table 12-45. Major Type 4-Minor Types 8 through 10 


Minor Type = 
Minor Type = 
Minor Type = 


8 Remote Window Open/Close (LOGMI N REMWINDOWV) 

9 MCS Window Open/Close (LOGMI N MCSWINDOWV) 

10 Direct Window Open/Close (LOGMI N_DIRWINDOWV) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


Type of action 

0 = Open 

1 = Close 

2 = Close all windows 




5 


LINK to program name (remote window open only) 




6 


LINK to window name (including dialog number) 




7 


Close reason 
200 = Normal 

202 = Pseudo deallocate 

203 = Disconnect 
206 = Release 

212 = Hello 

213 = Timeout 
217 = Security 




continued 
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Table 12-45. Major Type 4-Minor Types 8 through 10 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 


8 Remote Window Open/Close (LOGMIN REMWINDOWV) 

9 MCS Window Open/Close (LOGMIN.MCSWINDOWV) 

10 Direct Window Open/Close (LOGMTn DIRWINDOWV) 


Words 

VVUI lid 


UCdwl l|J UW 1 


8-9 


Not used 


10 


Origination information 
[23: 8] MCS number 
[15:16] LSN 


11 


Not used 


12-end 


Variable-length data pointed to by the LINKs in this entry 



Table 12-46. Major Type 4-Minor Type 1 1 


Minor Type = 


11 MCS Command (LOGMIN_MCSCCMDV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Length of command, in EBCDIC characters 


5-end 


Command string, in EBCDIC characters 
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Major Type = 5 NSP Entry (LOGMAJNSP) 



Table 12-47. Major Type 5-Minor Type 1 



Minor Type = 


1 NSP Initiate Entry (LOGNSPINIT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4-5 


Not used 


6 


Relative NSP number in [22: 7] with bit 23 on 


7-end 


DC prefix name in display form 


Table 12-48. Major Type 5-Minor Type 2 


Minor Type = 


2 MCS Initiate Entry (LOGMCSI NIT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


MCS number 


5-6 


Not used 


7-end 


MCS name in standard form 
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Table 12-49. Major Type 5-Minor Type 4 



Minor Type 


= 4 MCS Error Entry (LOGMCSMSG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


MCS number 


e 
O 


inoi useu 


6 


Word 0 of error result message (result class = 99) 




[23: 1] 1 is DLS, 0 is LSN 




[22:23] LSN 




[22: 7] Relative NSP number for DLS 




[15: 8] Line for DLS 




[ 7: 8] Station for DLS 


7 


Word 1 of the error result message 




[47: 8] RSLT byte index 




[39: 8] Line status 




[31: 8] Last flag 




[23:24] Error flag 


8 


Word 2 of the error result message 




Always 0 (zero) 


9 


Word 3 of the error result message 


10 


Word 4 of the error result message 




[23: 8] Original DCWRITE type 




[7: 8] Variant field 


11 


Error count 
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Table 12-50. Major Type 5-Minor Type 6 



Minor Type = 


6 UIO-DC Unsuccessful I/O (LOGUIOLINEFAULT) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




A 


ivHjo numuer 




5 


Not used 




6 


NSP number 




7 


LSP number 




8 


NSP words 0 through 2 of unsuccessful I/O result 






[47:16] Result count 






[31:16] Result number 






[15: 8] Result type 






[ 7: 8] Start of request number 




9 


NSP words 3 through 5 of unsuccessful I/O result 






[47:24] Request number 
















10 


NSP words 6 through 8 of unsuccessful I/O result 






[47: 8] Abort reason 






[39: 8] Request I/O 






[31:16] Command count 






[15:16] Data count 




11 


NSP words 9 through 1 1 of unsuccessful I/O result 






[47:16] Transfer count 






[31: 8] LEM port number 






[23: 8] Unit select 






[15: 8] Data transfer 






[ 7: 8] DLP number 




continued 



8600 0478-100 



12-187 



SUMLOG 



Table 12-50. Major Type 5-Minor Type 6 (cont.) 



Minor Type 


= 6 UIO-DC Unsuccessful I/O (LOGUIOLINEFAULT) 


Words 


Description 


12 


NSP words 12 through 14 of unsuccessful I/O result 

[47: 8] Selective clear 

[39: 8] Address parity 

[31: 8] Cleared DLP 

[23: 8] DLP status 

[15: 8] Exception 

[ 7: 8] Hung DLP 


13 


NSP words 15 through 17 of unsuccessful I/O result 

[47: 8] MLI longitudinal parity error 

[39: 8] MLI timeout 

[31: 8] MLI vertical parity error 

[23: 8] Nonpresent DLP 

[15: 8] Port busy 

[ 7: 8] Unexpected DLP status 


14-end 


Command and result 

[47:16] Number of bytes in the command. This is followed by the 
command for the specified length, a 16-bit quantity giving the length of the 
result, and the result for the specified length. 
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Table 12-5 1 . Major Type 5-Minor Type 7 



Minor Type = 


7 UIO-DC Abnormal Termination (LOGUIOPROCFAULT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


MCS number 


5 


Not used 


6 


NSP number 


7 


LSP number 


8 


Adapter number 


9 


NSP words 0 through 2 of abnormal termination result 

[47:16] Result count 

[31:16] Result number 

[15: 8] Result type 

[ 7: 8] Start of request number 


10 


NSP words 3 through 5 of abnormal termination result 

[47:24] End of request number 

[23: 8] Process history 

[15: 8] Abort reason 

[ 7: 8] Start of process index 


11 


NSP words 6 through 8 of abnormal termination result 
[47: 8] End-of-process index 
[39:16] PC segment 
[23:16] PC offset 
[7:8] Process type 


12 


NSP word 9 of abnormal termination result 

[47:16] Line number / station number. If the process type is Controller or 
LSP process, this field contains the line number. If the process type is 
Editor, this field contains the station number. 



8600 0478-100 



12-189 



SUMLOG 



Major Type = 6 Miscellaneous Entry (LOGMAJMISC) 



Table 12-52. Major Type 6-Minor Type 1 



Minor Type = 


1 Halt/Load Entry (LOGHL) 


words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


MCP and system identification 




[47:12] System serial number 




[35:12] MCP mark number 




[23:12] MCP level number 




[11:12] MCP patch number 


5 


LINK to MCP name 


6-8 


Halt/load cause as a string of EBCDIC characters 


9 


System identification 




[47:16] System serial number 




[31:24] Not used 




[ 7: 8] Operating system type 




0 = MCP 




1 = MCP 




2 = MCP/AS 


10-end 


Variable-length data pointed to by the LINK in this entry 
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Table 12-53. Major Type 6-Minor Type 3 



Minor Type = 3 SETSTATUS Call Entry (LOGSETSTAT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Information regarding parameters to SETSTATUS call 

[47: 8] TYPE, the first parameter 

[39: 8] SUBTYPE, the second parameter 

[31: 8] V, the third parameter 

[15:16] Number of words to follow in the entry 


5 for n words 


Contents of the array parameter to SETSTATUS where n is the number of 
words specified in field [15:16] of Word 4. 


If the length of the entire log record is greater than n + 5 words, the remaining words have the 
following meaning: 


n + 5 


Identity information code 

[47:06] Length of fixed part of entry in words 

[41:10] Entire length of identity information 


n + 6 


Miscellaneous identity information 
[07:08] Source of SETSTATUS command 

1 = From ODT 

2 = From remote ODT 

3 = From BNA connected host 

4 = From DCKEYIN 

5 = From MCS 


n + 7 


LINK to SOURCENAME task attribute value 


n + 8 


LINK to USERCODE task attribute value. This word is used only if the 
source of the SETSTATUS command was a BNA connected host (that is, 
field [07:08] of Word n + 6 stores a 3). 


71+9 


The V (third parameter) value of SETSTATUS 
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Note that the field [31: 8] of Word 4 differs from the third parameter value (V) in the 
following cases: 



Case Value in Word 4 [3 1 : 8] 

AD or DD V & (V.[10: 1]) [ 1: 1]&(V.[39: 1]) [ 2: 1] 

PPorXP IF V = -1 THEN 6 ELSE V 

SW- IF V = -1 THEN 6 ELSE V 



Note: The SETSTATUS call entry records a call to SETSTATUS, which is 
the MCP procedure called to carry out operator input commands. 
Thus, these records show most operator input that changes the status 
of the system, such as time and date changes, tapes purged, and tasks 
discontinued. 



Ta ble 1 2-54. Major Type 6-M i nor Type 4 



Minor Type 


= 4 Security Violation Entry (LOGSECURITY) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LI N K to usercode of violator 


5 


Violation code as follows: 




1 = Attempted to open a PRIVATE file 




2 = Attempted to open INPUT on a write-only file 




3 = Attempted to open OUTPUT on a read-only file 




4 = Attempted to open I/O on a read or write only file 




5 = Attempted to rename someone else's file 




6 = Attempted to create a permanent file not under your usercode 




7 = Attempted to execute a PRIVATE code file 




8 = Use of a usercode when SYSTEM/USERDATAFILE is not defined 




9 = Invalid usercode 




10 = Invalid password 




11 = Attempted to remove someone else's file 




12 = Invalid use of file name *USERCODE 




13 = Invalid use of security file attributes 



continued 
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Table 12-54. Major Type 6-Minor Type 4 (cont.) 



Minor Type 


= 4 Security Violation Entry (LOGSECURITY) 


Words 


Description 




14 = Attempted to COPY a PRIVATE file 




15 = Unauthorized user attempted to modify SYSTEM/USERDATAFILE 




16 = Not a viable usercode (no SYSTEM node in SYSTEM/USERDATAFILE 
entry) 




l / = ouspenoea usercoae 




18 = Old password required but not supplied (changing passwords) 




19 = Old password incorrect (changing passwords) 




20 = Invalid chargecode 




ci = invalid UotniyUUt/passworo 




£.£. = Attempted to copy a uUAKUtu Tile 




23 = Attempted to copy a CONTROLLED file 




24 = Attempted to execute a GUARDED file 




25 = Attempted to execute a CONTROLLED file 




26 = Attempted to execute a nonexecutable file 




27 = Invalid USERCODE when initiating a task 




28 = Invalid ACCESSCODE when initiating a task 




29 = Invalid task-to-task attribute: USERCODE 




30 = Invalid task-to-task attribute: ACCESSCODE 




31 = Invalid task attribute: no USERCODE 




32 = Invalid task attribute: USERCODE 




33 = Invalid task attribute: BDNAME 




34 = Invalid task attribute: ACCESSCODE 




35 = Invalid task attribute: JOBSUMMARYTITLE 




36 = Unauthorized user attempted to call SETSTATUS 




37 = Unauthorized user attempted to call GETSTATUS 




38 = Unauthorized user attempted to call DCKEYIN 




39 = Unauthorized user attempted to call ATTACHSPOQ 


continued 
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Table 12-54. Major Type 6-Minor Type 4 (cont.) 



Minor Type = 4 Security Violation Entry (LOGSECURITY) 
Words Description 

40 = Unauthorized user attempted to execute WFL VOLUME statement 

41 = Attempted to execute MU(PU) system command 



42 




USERCODE no longer valid for CONTROLCARD 


43 




USERCODE no longer valid for JOBRESTART 


44 




USERCODE no longer valid for TASKRESTART 


45 




Unauthorized call to Prints 


46 




Invalid USERCODE/PRINTCHARGE 


47 




Invalid USERCODE for Prints Transform 


48 




Attempted to rename a GUARDED file 


49 




Attempted to rename a CONTROLLED file 


50 




Unauthorized user attempted to execute security critical function 


51 = Unauthorized user attempted to execute ??SECAD- system 
primitive command 


52 




Attempted to execute a restricted file 


53 




Attempted to execute file on restricted family 


54 




Attempted to copy a restricted file 


55 




Attempted to copy file from restricted family 


56 




Attempted to CM to a restricted file 


57 




Attempted to CM to file on a restricted family 


58 




File security prevented row exchange 


59 




Expired password 


60 




Expired USERCODE 


61 




Attempted to set a file attribute without write access 


62 




Attempted to create a restricted file 


63 




Userdata function not allowed on password generating system 


64 




Makeusercode request denied 


65 




Library linkage class security violation 



continued 
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Table 12-54. Major Type 6-Minor Type 4 (cont.) 



Minor Tvne 


= 4 Security Violation Entrv (LOGSECURITY) 


Words 


npsrrintion 




fifi = flannnt accp<;^ transform lihrarv hv titlp 




fi7 = Minimum na^wnrrl lifp<%nan pnfnrrpd naQQwnrH rhancrp failprl 

\J / 1 VI 1 1 1 1 1 1 1 U 1 1 1 L/CIOO VVUIU II 1 wOL/CJ 1 | 1>I 1 1 Ul UUU f L/CJOO VV Ul \J V>l Id 1 IgU 1 CJI 1 v»VJ 




fift — P^QQ\A/nrH rprpntlv iiqpH nacQwnrH rhancrp failpH 




fiQ — Prnarrsim Hiimn filf* /*nnioH 




70 — Attpmnt tn rnnw a nrncrram rlumn filp to a rp^trirtpri rip^tination 




71 — Attpmnt tn nnpn a kpv<ifilp 




79 — Attpmnt tn nnpn t\ rhprknnint filp 




73 = Attemnt to onpn a orotrram dumo file 




74 = Attempt to use a catalog command on a file 




75 = Attempt to use ARCHIVE PURGE command on a file 




76 = Attempt to update the archive record for a file 




77 = Attempt to read the archive record for a file 




78 = Usercode invalid because not in correct date and time range 




79 = Attempt to copy or archive files from another user's directory 




80 = Family owner mismatch or security error on tape open 


c 
o 


LIINrx lO ndlllc VCoil Uc Hie lldlllc, pdbbWUlU dllU bU Ull, UcpcilUlllg U|JUII 




violation involved) 


7 


LINK to access code 


8 


Violation origin information 




[47: 1] Task originated from a WFL queue 




[46:10] Queue from which task originated 




[36:15] Unused field 




[21: 6] MCS from which task originated 




[15: 1] Task originated from data comm 




[14:15] Unused 



continued 
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Table 12-54. Major Type 6-Minor Type 4 (cont.) 



Minor Type 


= 4 Security Violation Entry (LOGSECURITY) 


Words 


Description 


9 


If task originated from data comm, LSN of originating terminal; otherwise, 
unit number of originating peripheral 


10-end 


Variable-length data pointed to by the LINKs in this entry 


Table 12-55. Major Type 6-Minor Type 5 


Minor Type 


= 5 Deimplementation Warning Entry (LOGDEI MPWARNI NG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Deimplementation warning information 
[7: 8] Warning number 


5 


LINK to external name of task 


6 


LINK to usercode 


7 


LINK to compiler file name 


8 


Task source and destination information 

[45: 6] Destination MCS 

[39: 1] Destination is remote 

[38:15] Destination UNIT 

[21: 6] Originating MCS 

[15: 1] Origin is REMOTE 

[14:15] Originating UNIT 

If bit [15: 1] is set, this field contains a logical station number (LSN). If bit 
[15: 1] is reset, this field contains the logical unit number. 
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Table 12-55. Major Type 6-Minor Type 5 (cont.) 



Minor Type = 


D ueimpiementation warning bntry (LOuULin/irWAKNiNu) 


Words 


Description 


9 


Compiler information 




[31: 8] Language type 




[23: 8] Compiler mark number and level number 




[ 9:10] Compiler cycle number 


10 


LINK to value of itinerary chain 


11-end 


Variable-length data pointed to by the LINKs in this entry 



Table 12-56. Major Type 6-Minor Type 6 



Minor Type = 


6 Log Power Off (LOGPOWEROFF) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Power-off indicator 




[47:16] System serial number 




[ 7: 8] Type of power-off 




1 = Scheduled power-off 




2 = Unscheduled due to thermal overload 




3 = Thermal overload warning 




4 = Unscheduled power-off (request for immediate power-off) 




5 = Canceled power-off 




6 = Actual power-off 




7 = Blower failure 
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Table 12-57. Major Type 6-Minor Type 7 



Minor Type = 


7 Controller Command (LOGMI N CONTRCMDV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Length of command, in EBCDIC characters 


5 torn 
characters 


Command string in EBCDIC characters, where n is the number of 
characters specified in field [15:16] of Word 4. 


If the length of the entire log record extends beyond that needed to to accommodate the 
command string, the remaining words have the following meaning, where m is the index of the 
first such word: 


m 


Identity information code 

[47:06] Length of fixed part of entry in words 

[41:10] Entire length of identity information 


m + 1 


Miscellaneous identity information 
[07:08] Source of SETSTATUS command 

1 = From ODT 

2 = From remote ODT 

3 = From BNA connected Host 

4 = From DCKEYIN 

5 = From MCS 


m + 2 


LINK to SOURCENAME task attribute value 


m + 3 


LINK to USERCODE task attribute value. This word is used only if the 
source of the SETSTATUS command was a BNA connected host (that is, 
field [07:08] of Word n + 6 stores a 3). 
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This entry describes the modification or deletion of a print request as the result of an 
operator command. 



Table 12-58. Major Type 6-Minor Type 8 



Minor Type = 


8 Print Subsystem Command (LOGPSCOMMAND) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


Command information 






[47: 8] Type of PS command 






1 = ADDFILES 






2 = ASSOCIATE 






3 = BNA 






4 = CONFIGURE 






5 = DEFAULT 






6 = DELETE 






7 = DEVICES 






8 = FORCE 












10 = MODIFY 






11 = NOTOK 






12 = OK 






13 = REQUEUE 






14 = SERVERS 






15 = SKIP 






16 = STOP 






[31: 4] Result information 






[27:28] Request number, if applicable 




5 


LINK to usercode of print request originator 




6 


LINK to station name of command originator 




7 


LINK to usercode of command originator 




8 


LINK to command text 




9 


Session number of command originator 




continued 



8600 0478-100 



12-199 



SUMLOG 



Table 12-58. Major Type 6-Minor Type 8 (cont.) 



Minor Type 


= 8 Print Subsystem Command (LOGPSCOMMAND) 




Words 


Description 




10-end 


Variable-length data pointed to by the LINKs in this entry 




Table 12-59. Major Type 6-Minor Type 9 


Minor Type 


= 9 USERDATA Change (LOGMI N_CHANGEUSERV) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


Action 

[12: 1] Action was for remote user 
[11: 4] USERDATA operation 

(Modify/create/delete/see entry = 7) 

5 = Modify 

6 = Create 

7 = Delete 

[ 7: 4] USERDATA Subfunction 
[ 3: 4] USERDATA Function 




5 


LINK to information (specific for USERDATA function) 
(Password change = 6) 

Usercode 
(Modify/create/delete/see entry = 7) 
(Create entry using model = 8) 

Doings parameter to USERDATAREBUILD 
(Change accesscode/password = 12) 
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Table 12-59. Major Type 6-Minor Type 9 (cont.) 


Minor Type = 


9 USERDATA Change (LOGMI N CHANGEUSERV) 


Words 


Description 




Usercode/accesscode 


6-end 


Variable-length data pointed to by the LINK in this entry 



Note that the system creates a backup copy of the USERDATAFILE whenever an 
entry of Major Type 6, Minor Type 11 (New USERDATA Install) is logged. Refer to 
"Requesting Copies of Configuration Files" earlier in this section. 



Table 12-60. Major Type 6-Minor Types 10 and 11 



Minor Type = 
Minor Type = 


10 New USERDATA Install & Copy (LOGMI N NEWUSERCOPYV) 

11 New USERDATA Install (LOGMI N_NEWUSERV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to installed file title 


5 


LINK to copied file title 


6 


Action 

1 = USERDATA create 

2 = USERDATA recall 

3 = USERDATA copy new (a copy is not made for this case) 


7-end 


Variable-length data pointed to by the LINKs in this entry 
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Table 12-61. Major Type 6-Minor Type 12 



Minor Type = 


12 Primitive Command (LOGMINPRIMCMDV) 


Words 


Description 


0-3 
4 

5-end 


As described in Table 12-2, "First Four Log Entry Words" 
Length of command, in EBCDIC characters 
Command string, in EBCDIC characters 


Table 12-62. Major Type 6-Minor Type 13 


Minor Type = 


13 idle System Times (LOGMINTIMERV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


Table 12-63. Major Type 6-Minor Type 14 


Minor Type = 


14 Halt/Load Reason (LOGMINHL2V) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


MCP and system identification 
[47:12] System serial number 
[35:12] MCP mark number 
[23:12] MCP level number 
[11:12] MCP patch number 
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Table 12-63. Major Type 6-Minor Type 14 (cont.) 



Minor Type = 


14 Halt/Load Reason (LOGMIN HL2V) 




Words 


Description 




5 

6-8 


LINK to MCP name 

Halt/load cause as a string of EBCDIC characters 




Q 


oystem laeniiiicaiion 
[47:16] System serial number 
[31:24] Not used 
[ 7: 8] Operating system type 

0 = MCP 

1 = MCP 

2 = MCP/AS 




10-end 


Variable-length data pointed to by the LINK in this entry 




Table 12-64. Major Type 6-Minor Type 15 


Minor Type = 


15 DRC error logging (LOGMIN_DRCV) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


Error code 

1 = Invalid FAMILYNAME in USERDATA FAMILYLIST entry 

2 = USERDATA record overflow 

3 = USERDATA error 




5 


LINK to usercode 
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Table 12-64. Major Type 6-Minor Type 15 (cont.) 


Minor Type = 


15 DRC error logging (LOGMIN_DRCV) 


Words 


Description 


6 


LINK to additional information. Error codes 1 and 2 are USERDATA 
FAMILYLIST entries; error code 3 is a USERDATA result. 


7 


Variable-length data pointed to by the LINKs in this entry. 



Table 12-65. Major Type 6-Minor Type 16 



Minor Type = 


16 Security Relevant Warning (LOGMI N SECWARNV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Warning code 




1 = Support Library Replaced 


5 


LINK to additional information. For warning code 1 it is a link to the 




FUNCTIONNAME library attribute value. 


6 


Variable-length data pointed to by the LINKs in this entry. 
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Reserved for installation use. 
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Major Type = 10 Date/Time Reset Entry (LOGMAJDATETIMERESET) 

The date/time reset log entry is a single, 30-word record that is always the first record 
in the log file. It is used to record the location of the first 26 date/time changes that 
occur while this log file is active. Only date/time changes that reset the date or time to 
a value earlier than the current date or time are recorded. This entry is updated each 
time such a change is made. 



Table 12-66. Major Type 10-AII Minor Types 



Minor Type 


= 


1 Log created by A 2 


Minor Type 




2 Log created by A 6 


Minor Type 




5 Log created by A 3 


Minor Type 


: 


6 Log created by A 9 


Minor Type 




7 Log created by A 15 


Minor Type 




9 Log created by A 10 


Minor Type 




10 Log created by A 5 


Minor Type 


= 


15 Log created by A 12 


Minor Type 




16 Log created by A 1 


Minor Type 


_ 


17 Log created by A 17 


Minor Type 


= 


19 Log created by A 4 


iviinor iype 




zu Log created py iviicro a 


Minor Type 


= 


21 Log created by A 16 


Words 




Description 


0 




Record Group Description 






[47: 8] = 1 






[39: 8] = 1 






[31:16] = Serial number of system that created log 






[15:16] = Serial number of SUMLOG 


1 




Julian date in binary when this entry was first written 


2 




Time of day when this entry was first written 


3 




Log entry type code 






[47: 6] = 0 






[41:10] = Number of date and time resets recorded 






[31:16] = 10 (Major Type) 






[15:16] = Type of system that created the log: 






1 = A2 






2 = A6 
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Table 12-66. Major Type 10-AII Minor Types (cont.) 



Minor Type 




i Log created Dy a z 


Minor Type 





2 Log created by A 6 


Minor Type 




5 Log created by A 3 


Minor Type 




6 Log created by A 9 


Minor Type 




7 Log created by A 15 


Minor Type 


= 


9 Log created by A 10 


Minnr T\ino 
ivilliui 1 ypc 




1 n 1 act f*roaiofl Kv/ A R 
iv L.Ug Clvdlcu uy M 


Minor Type 


= 


15 Log created by A 12 


Minor Type 


= 


16 Log created by A 1 


Minor Tuno 




17 1 nor rre>ate>f\ hv A 1 7 


Minor Type 


= 


19 Log created by A 4 


Minor Type 


— 


20 Log created by Micro A 


Minor Tvnp 




21 Lop created bv A 16 


\klnrAf 

words 




Description 






5 = A 3 






6 = A 9 






7 = A 15 






9 = A 10 






10 = A 5 






IE A 1 O 






16 = A 1 






17 = A 17 






19 = A4 






20 = Micro A 






21 = A 16 


4-29 




Contain pointers (relative record numbers) to the last entry with the old 






time (this entry's time and date will be greater than the next entry's time 






and date). 






If bit 47 is set in a word, there are additional time breaks in the log that 






have not been recorded in this record. This word is the last pointer 






provided. The remaining words in the entry do not contain pointers. 
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Major Type =11 BNA Version 1 Entry (LOGMAJBNA) 

Log entries of Major Type 11 record system actions that are related to BNA Version 1. 

Tables 12-67 through 12-72 are referred to in many of the Major Type 11 log entry 
descriptions. 



Table 12-67. NS Error Codes 



Number 


Description 




1 


ILLEGAL NUMBER 




2 


BNA VERSION 1 COMMAND EXPECTED 




3 


THIS FEATURE IS NOT YET IMPLEMENTED 




4 


NUMBER EXPECTED 




5 


BOOLEAN VALUE EXPECTED 




6 


NUMBER IS TOO LARGE 




7 


RESERVED WORD EXPECTED 




8 


INVALID LINK RESISTANCE FACTOR 




9 


NUMBER IS TOO SMALL 




10 


THERE IS NO NEXT SCREEN 




11 


PRINT OPTION EXPECTED 




12 


NO SUSPENDED FILE 




13 


FILE ALREADY SUSPENDED 




14 


MORE INPUT EXPECTED 




15 


EQUAL SIGN (=) EXPECTED 




16 


MODULUS ATTRIBUTE MUST BE 8 OR 128 




17 


END OF COMMAND EXPECTED 




18 


ILLEGAL OUTPUT DESIGNATION 




19 


RIGHT PARENTHESIS EXPECTED 




20 


COMMAND NOT ALLOWED FROM INPUT SOURCE 




21 


ILLEGAL TITLE 




22 


I/O ERROR READING INPUT FILE 




23 


INPUT FILE IS SUSPENDED - CONTINUE OR DISCARD 




24 


NO FILE BEING LOADED 




25 


FILE LOAD IN PROCESS 




26 


DEBUG OPTION EXPECTED 




27 


PLUS OR MINUS EXPECTED 
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Table 12-67. NS Error Codes (cont.) 



Number 


Description 


28 


POUND SIGN (#) EXPECTED 


i 29 


COLON (:) EXPECTED 


30 


ALL EXPECTED 


31 


AGENT NAME EXPECTED 


32 


YOUR-NAME OF SUBPORT EXPECTED 


33 


STRING EXPECTED 


34 


INVALID NEIGHBOR RESTART TIMEOUT VALUE 


35 


COMMA (,) EXPECTED 


36 


COMMAND IS NOT VALID DURING THE CURRENT PHASE OF THE 

INC. 1 VVv^r\r\ 


o / 


nFCTIMATinM Hn<iT IC 1 INRFAPUARI F 
UCO 1 IINMi IUIN nUo 1 lo UlNnLMUrlMDLt 


JO 


QOI IRPF HO<5T IQ 1 INRFAPHARI F 
ovjunoc. nvjoi io uiNr\CMonMDLC 


3Q 


Tn FYPFPTFI"! 


t\j 


INVAI in MAY <5Ff5MFMT <?I7F 

IINVrtLIU mMA OL.V3lvlL.lNI OI/.L. 


41 


INVALID NETWORK VERSION 


42 


INVALID NEIGHBOR GREETING TIMEOUT VALUE 


43 


STRING TOO LONG 


44 


INVALID NEIGHBOR BUSY TIMEOUT VALUE 


45 


SOURCE AND DESTINATION ARE SAME NODE 


46 


USERCODE EXPECTED 


47 


AGENT EXCEEDS MAX PROGRAM AGENTS 


48 


THIS ATTRIBUTE CANNOT BE SET WHEN PROGRAM AGENTS ARE 
CONNECTED 


A r\ 

4y 


FAILURE DUE TO SOFTWARE ERROR 


en 
ou 


1 ICFRPOnF to A | | OWFn AMI V \A/MFM PROGRAM AfSFNT QFPI IRITV IC 
UoLr\L>vJUC. lo MLLUVVCU VJINLT WntlN rlMJurvMIVI MUCIN 1 oEX>Ur\l 1 T lo 

PRIVATE 


51 


HOST ALREADY ADDED 


52 


HOST NOT DELETED, HOST IS COMMUNICATING 


53 


HOST VALIDATE IS FALSE, COMMAND HAS NO MEANING 


54 


ROUTER VALIDATE IS FALSE, COMMAND HAS NO MEANING 


55 


HOST NAME AND/OR NODE ADDRESS REQUIRED 


56 


HOST NAME AND/OR NODE ADDRESS MUST FOLLOW THE WORD WITH 
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Table 12-67. NS Error Codes (cont.) 



Nnmhpr 


Dsserinlion 


0/ 


UAOTMAMC DcmiiDcn 
nubl INAML KtUUIKtU 


CO 

bo 


miooimp m aac aaadccc 
MlbbllNb. INUUt AUUKtbb 


by 


ll/\CT MAM IT CVDCPTm 

HUbl INAMt LArtLItU 


bU 


INUDt ADUKtbb tArtUI tU 


bl 


1 or> a 1 Mfinc ArsrvDCcc to ai DCArw oct 
LUL.AL INUUt AUUKtbb lb ALKtAUY btl 


CO 
0<£ 


1 MX/At ir\ l_I ACT MAHC 

IINVALIU HUbl INAMt 


CQ 
Do 


IINVALIU INUUt AUUKtbb 


a a 

o4 


unoT MAMT IO MOT rMTETINICTl 

HUbl INAMt lb INUI UtrllNtU 


cc 
bo 


Mnnc Annoccc 10 mat ncciwcn 
INUUt AUUKtbb lb INU 1 UtrllNtU 


cc 
bo 


MUbl INAMt - INUUt AUUKtbb UU INUI MAIL-n 


C"7 

b/ 


MClPUDnD MAT DTDMITTCri UCDC 

INtlvaHBUK INUI rtKMII 1 tU ntKt 


c o 

be 


MCIPUDOD Ml IOT DC ODtriCICn 

INtlGHBUK MUbl Bt brtUlrltU 


CO 

by 


i ppai Mnnc mot ai i nw/cn im pommanh 

LUL-AL INUUt INUI ALLUWtU IIN UUMMAINU 


/U 


OTATIAM OD CAIOCMQI C MAMT DCTMIIDCH 

blAI IUIN UK tINbtMBLt INAMt KtUUIKtU 


71 


OTATIAM OD ETMOCMDI C MAMET Ml IOT CAI 1 OVA/ TUIC \A/ADr\ DV 

SIAilUINUK tINbtMBLt NAMt MUbl rULLUW 1 nt WUKU BY 


■70 


MA oi IPU OTATIOM 
INU bUUli b 1 A 1 IUIN 


70 


OTATIOM IO INPOMINfS ONI V TVPF 
blAI IUIN lb IINUUIVIIINva-UINLT 1 Yrc. 


7A 


OTATION MHT AP.I F TH RFPFIVF INlPPiMINP. PAI 1 C 
blAIIUIN INUI MDLl 1 U nuLtLIVu IINUUIVIIINU UMLLo 


"7C 
/ O 


OTATIOM MOT ARI F TO PI APF Ol ITP.OI NP. PAI 1 C. 
b IAI IUIN INU 1 ADLC. 1 U r LMUH UU 1 uUIINo bMLLo 


/b 


OTATIOM IO PFDM AMFMT TVPF 
b 1 AI IUIN lb rtrvMAINtIN 1 1 Yr t 


/ / 


OTATIOM IO P.I OP.AI MFMORV TVPF 
b 1 AI IUIN lb uLUDAL MCIVIUKT 1 Trt 


70 
/o 


OTATIOM IO ROI P TVPF 
blAIIUIN lb DULL. Iirt 


7Q 

/y 


OTATIOM ICY OK TVPF 
blAIIUIN lb A. ZD 1 Yrt 


oU 


OTATIAM MAMF DFOIIIDFH 
blAI IUIN INAMt KLUUIKLU 


81 


STATION NAME MUST FOLLOW 'BY STATION' 


82 


STATION NAME IS INVALID 


83 


STATION IS NOT PERMANENT TYPE 


84 


LCPACKETSIZE ATTRIBUTE MUST BE MODULO 16 


85 


ENSEMBLE NAME IS NOT DEFINED 


86 


ENSEMBLE IS INCOMING-ONLY TYPE 


87 


ENSEMBLE NOT ABLE TO RECEIVE INCOMING CALLS 
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Table 12-67. NS Error Codes (cont.) 



Klumhpr 


np<rrintinn 


no 

oo 


CMCCMDI C MrtT ADI C TC\ Dl APE IT/^/'llMf* r>AI 1 O. 

tINbtMBLt INUI ABLt IU rLALt UU 1 CaUINla LALLb 


on 

oy 


CMCCM Di C IO. DCDMAMCMT TVDC 

tINbtMBLt lb rtKMANtlN 1 1 Yrt 


on 

yu 


rMccu di c ic i adai mcm/~\dv tvot 
LINStMBLt IS GLOBAL MEMORY TYPE 


Q 1 

y i 


CMCITMDI C IC DrM C TVDC 

tlNStMBLE IS DULL- lYrt 


y<i 


CMOCMDI C IO V OK TVDC 

EINbEMBLE IS A.Zo l Yrt 


no 

yo 


CMCCk/IDI C MAME DCni IIDCH 

EINbEMBLE INAME KEUUIKEU 


y*t 


cnqcmri c mamf mi ict cni i n\A/ >nv cnqcmri c 

tINotlVIDLL INAMt MUol rULLUW BY tINbtMBLt 


yo 


CMCCMRI C MAMC IC IMWAI IH 

tINbtMBLt INAMt lb INVALID 


3D 


FNQ.FMRI C |Q MOT PFRM ANFIMT Type 
DINoCIVI DLL lo INUI r LiaIVIHINLIN 1 1 TrL 


Q7 


STATION NOT Rm P ^.WITPHFn STATION 

OIMIIVJIN INUI DULO OVVI lOnLU O 1 M 1 IUIN 


JO 


mNNIFPTinN TO THR NFIfiHROR HA°, Al RFADY RFFN AnDFD 

V/N-/ININCU 1 IUIN l\J 1 nlO MLIunDvrV rlnO nLnLnUl DLLli AL/uLl^ 


99 


NO CONNFPTION TO THIS NEIGHBOR HAS BEEN DEFINED 


1 00 


CONNECTION ATTRIBUTES REQUIRED 


101 


CALL-DATA REQUIRED 


102 


CALL-DATA EXPECTED 


103 


INIT-QUANTITY REQUIRED 


104 


1 NIT-QUANTITY EXPECTED 


105 


CALL-DATA NOT PERMITTED HERE 


106 


NEIGHBOR PHRASE REQUIRED FOR OUTGOING CALLS 


107 


CALL-DATA MUST BE SUPPLIED 


108 


CALL-DATA ALREADY SUPPLIED IN CONNECTION - NOT PERMITTED 
HERE 


109 


INIT-QUANTITY NOT PERMITTED HERE 


110 


STATION BELONGS TO ENSEMBLE: CONNECTION MUST SPECIFY THAT 
ENSEMBLE 


111 


CALL-DATA TOO LONG 


112 


INIT-QUANTITY TOO LARGE 


113 


STATION OR ENSEMBLE HAS ACTIVE CONNECTION TO NEIGHBOR 


114 


STATION HAS NON-ZERO INIT-QUANTITY IN OTHER OUT CONNECTION 


115 


NO SUCH CONNECTION 


116 


STATION OR ENSEMBLE HAS ACTIVE CONNECTION 
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Table 12-67. NS Error Codes (cont.) 









1 1 "7 


LONNtL 1 ION HAS NO Al I KIdU 1 to 1 O MUDIrY 




1 1 Q 

1 lo 


1 M\/A 1 1 P\ A Pi Pi ADTIrtM 

INVALID ADD Ur 1 IUN 




1 in 


IMV/AI in PiCI CTC ADTIAM 

INVALIU UtLt 1 1 Url IUN 




l^U 


im\/ai in n/inmnv adtiam 
INVALIU MUUIrY Url IUN 




1 9 1 
l<il 


INVALIU oAVL Url IUN 




1 99 


invai in RFAnv option 

1 IN VAALI U IaLMU I \J~ 1 l\JW 




193 


INX/AI in <5Mn\A/ DPTIDN 

IINVr\l_IL' onV-<VV \Jr 1 IVJIN 




1 9 A 


invai in NnnF i ip timfoi it \/ai i if 

IINVHLIL' INVJUl. Ur IIIVIL.VJUI VnLUL 




1 9R 


1 FFT PARFNTMFQI<5 FYPFPTFn 
Lcr i rrtntiN i riLOio cat qu i lu 




1 9fi 


STATION ATTRIRIITF FYPFPTFn 

OIMIIVJINMI 1 nlDU 1 L LArto 1 uu 




1 97 


1 nPAl mFNTITY HA<^ NOT RFFN «^FT 

LVJ(_ir\l_ 1 LVL.IN 1 1 1 I nno INW 1 DL.L.IN OL 1 




1 98 


NonF not nFi FTFn ndhf i<? pnNNFPTFn nfirhror 




1 9Q 


NnnF K NnT A NFIGHRnR 
invjl/u. lo in^ I r\ I n l.i vj n Dvr\ 




i 30 

1 ow 


NnnF ai RFAnY AnnFn 






PnRT NAMF FYPFPTFn 
r \Jl\ 1 INrtlVIH LArtu 1 Lu 




1 39 


ii i FfiAi PA^wnRn 




1 33 


INVAI in PAI 1 nATA 

IINVMLIL/ UnLL LJr\ 1 AA 




1 3A 


McccAfiF tfxt Tnn 1 nNfi 

IVI LOOnu L. 1 HAI \\J\J LvJINVJ 




1 3R 


niRFPTinN HM m IT PFRMX RFPilllRFH 
L/l r\L.w 1 IVJIN vMN, \JU 1, i Cixlviy rxCVjIUIrVllL/ 




lob 


AAI 1 o MAT Al 1 n\A/Cn MCT\A/ADI/ IC IMITIAI I7IMA 

LALLo NUI ALLUWLU - NtlWUKft lo INI 1 IALIZJINIj 




1 Q"7 

lo/ 


AAI 1 O MAT Al 1 A\A/ITPi MCTNA/ADI/ IO OLJI ITTIMA AA\A/M 

UALLo NU 1 ALLUWtU - Nt 1 WUKft lo onU 1 1 INb UUWN 




loo 


DACc\A/nDn taa i amp 
rAooWUKU 1 UU LUNLi 




i oy 


ni IDI IPATF PADAHillTTCD 

UUrLIL-AI L rAKAMLI LK 






□ ACT MAK/IP nr>CC MAT MATPU 
nUo 1 INAML UULo NUI MAlLti 




141 


PROGRAM AGENT WAS PREVIOUSLY SPECIFIED 




142 


STATION NOT AVAILABLE 




143 


STATION IS SAVED 




144 


STATION IS IN MANUAL MODE 




145 


STATION ALREADY CLOSED 




146 


STATION REQUIRES CALL-DATA FOR OUTGOING CALL 




147 


CALL-DATA NOT ALLOWED FOR STATION 
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Table 12-67. NS Error Codes (cont.) 



Number 


Description 


148 


STATION NOT IN CORRECT STATE 


149 


STATION IS NOT ATTACHED 


150 


ISC STATION GROUP ATTRIBUTE EXPECTED 


151 


STATION-TYPE ATTRIBUTE NOT MODIFIABLE 


152 


ISC STATION GROUP NOT ALLOWED 


153 


ISC STATION NOT ALLOWED 


154 


HUB NUMBER ALREADY IN USE BY ANOTHER ISC GROUP 


155 


STATION NAME APPEARS IN LIST TWICE 


156 


HUB NUMBER REQUIRED 


157 


INVALID STATION TYPE 


158 


CONNECTION WAS NOT SPECIFIED 


159 


CALL CANNOT BE MADE ON THIS STATION 


160 


ENSEMBLE HAS AN ACTIVE STATION 


161 


ISC GROUP SHUTDOWN IN PROGRESS 


162 


NO ACTIVE STATIONS FOR GROUP 


163 


ACTIVE STATIONS CURRENTLY IN GROUP 


164 


STATION HAS CONNECTION DEFINED 


165 


ENSEMBLE HAS CONNECTION DEFINED 


166 


STATION IN ENSEMBLE NOT OF PROPER TYPE 


167 


X.25 ENSEMBLES VC CANNOT BE MODIFIED 


168 


STATION NOT IN THAT ENSEMBLE 


169 


STATION ALREADY IN AN ENSEMBLE 


170 


CAN'T DELETE STATION FROM ENSEMBLE 


171 


STATIONS IN OUT ENS NEED SAME SPEED 


172 


NO STATIONS AVAILABLE 


173 


ALL STATIONS IN ENSEMBLE ARE CLOSED 


174 


CAN'T DELETE LAST STATION IN ENSEMBLE 


175 


USERCODE IS REQUIRED WHEN PROGRAM AGENT SECURITY IS 
PRIVATE 


176 


STATION ALREADY ADDED 


177 


ENSEMBLE ALREADY ADDED 
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Table 12-67. NS Error Codes (cont.) 



Number 


Description 


178 


INVALID STATION ATTRIBUTE 


179 


INVALID ISC GROUP ATTRIBUTE 


180 


CAN'T ADD STATION TO ENSEMBLE WHILE STATION IS ATTACHED 


181 


CAN'T DELETE STATION FROM ENSEMBLE WHILE STATION IS 
ATTACHED 


182 


TIME-INTERVAL TOO SMALL 


183 


Tl M E-l NTERVAL TOO LARGE 


184 


X.25 STATION NOT ALLOWED 


185 


STATION IS NOT X.25 GROUP STATION 


186 


STATION IS NOT AN X.25 STATION 


187 


STATION GROUP IS NOT OPEN 


188 


LCN RANGE IS GREATER THAN NUMBER OF STATION NAMES 
DECLARED 


189 


LCN RANGE IS LESS THAN NUMBER OF STATION NAMES DECLARED 


190 


X.25 PDN NAME EXPECTED 


191 


MODIFIED ATTRIBUTE ALLOWED ONLY WHEN PDN IS NULL 


192 


X.25 LCN ALREADY ADDED 


193 


STATION-TYPE ATTRIBUTE REQUIRED 


194 


STATION-TYPE MUST BE THE FIRST ATTRIBUTE SPECIFIED 


195 


STATION STATUS MUST BE CLOSED 


196 


THIS COMMAND IS ALLOWED ONLY WHEN BNA VERSION 1 IS 
COMPILED WITH DIAGNOSTICS SET 


197 


ALLC-REFERENCE REQUIRED 


198 


INVALID SECURITYTYPE 


199 


INVALID FILENAME 


200 


PORT ATTRIBUTE EXPECTED 


201 


INVALID YOUR NAME 


202 


SECURITYGUARD IS USED ONLY IF SECURITYTYPE IS GUARDED 


203 


YOURNAME REQUIRED 


204 


STATION CURRENTLY UNASSIGNED 


205 


NO TARGET ENTRIES IN DIRECTORY 


206 


NO SUCH TARGET 
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Table 12-67. NS Error Codes (cont.) 



Number 


Description 


207 


NO SUCH ALLC 


208 


NO ALLC ENTRIES IN DIRECTORY 


209 


TARGET ALREADY ADDED 


210 


MISSING ALLC ENTRY 


211 


TARGET NOT DELETED, CURRENTLY IN USE FOR ALLC ACTIVATION 


212 


TARGET NOT REPLACED, CURRENTLY IN USE FOR ALLC ACTIVATION 


1 213 


ALLC ALREADY ADDED 


214 


ALLC NOT DELETED, IS REFERENCED BY TARGET 


215 


YOURNAME ATTRIBUTE NOT SET 


216 


SECURITYGUARD MUST BE SPECIFIED IF SECURITYTYPE IS GUARDED 


017 


nr\KAKJi AMH IC IM\/AI in OTATIOM IC ACCIPMCn 


218 


1 Kl\ / A 1 1 f"N TP A r»/*N f~TT 1 P\ 

INVALID TARGET-ID 


219 


TARGET-ID EXPECTED 


220 


ACTIVATION STRING EXPECTED 


I 221 


STATION OR ENSEMBLE NOT ASSIGNABLE TYPE 


222 


STATION ALREADY ASSIGNED 


223 


ASSIGNED FUNCTION NOT IMPLEMENTED 


224 


TOO MANY ALLC REFERENCES 


225 


TOO MANY TARGETS 


226 


ALLC-REFERENCE INVALID 


227 


INVALID REPLACE OPTION 


228 


ILLEGAL FUNCTION REQUESTED 


229 


LENGTH OF TEST FRAME TOO LONG 


230 


MAXIMUM SEGMENT SIZE MAY NOT BE LESS THAN NETWORK MAX 
SEG SIZE 


231 


MAXIMUM SEGMENT SIZE IS TOO LARGE 
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Table 12-68. NSM Error Codes 



Number 


Description 




1 


INVALID PRIORITY 




2 


INVALID LEVEL 




3 


INVALID FRAME TYPE 




4 


TRANSIT COUNT LIMIT EXCEEDED 




5 


UNKNOWN ORIGIN NODE ADDRESS 




6 


UNKNOWN DESTINATION NODE ADDRESS 




7 


DESTINATION NODE UNREACHABLE 




8 


INVALID CONTROL TYPE 




9 


UNKNOWN SUBJECT NODE ADDRESS 




10 


INVALID HOP COUNT 




11 


INVALID RESISTANCE FACTOR 




12 


INVALID CAUSE 




13 


INVALID MAXIMUM HOP COUNT 




14 


INVALID MAXIMUM RESISTANCE FACTOR 




15 


INVALID RELEASE LEVEL 




16 


INVALID TRACE REFERENCE 




17 


UNKNOWN RECEIVING NODE ADDRESS 




18 


UNKNOWN NEIGHBOR NODE ADDRESS 




19 


UNKNOWN PDN-ID 




20 


INVALID MAXIMUM SEGMENT SIZE 




21 


INVALID STATION-QUEUE-ID 




22 


UNKNOWN STATION-QUEUE-ID 




23 


INVALID LINK-PENDING VALUE 




24 


INVALID REMOTE RESISTANCE FACTOR 




25 


INVALID LOCAL RESISTANCE FACTOR 




26 


INVALID OPERATIONS RESISTANCE FACTOR 




27 


INVALID PHYSICAL LINK STATION-ID 




28 


INVALID PHYSICAL LINK VAN-ID 




29 


INVALID PHYSICAL LINK SPEED 




30 


INVALID PHYSICAL LINK EFFICIENCY 




31 


INVALID PHYSICAL LINK MAXIMUM SEG SIZE 
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Table 12-68. NSM Error Codes (cont.) 



Kli imhor 
nUlflDci 


Description 




32 


CV^CCnm kJIAVHJII IRA OC/"*fcACNIT f»l7C CAn 1 IKII/ 

EXCEEDED MAXIMUM SEGMENT SIZE FOR LINK 




66 


MAHC Al DCArvV CVIOTC 

NODE ALREADY EXISTS 




34 


IMWAI 1 Pi KI/"M"\C AnPiDCOO 

INVALID NODE ADDRESS 




35 


irv/~*cr7r\rr\ h a a vi a ai i k a mi iudtd /"Mr dadai i ci i ikii/o 

EXCEEDED MAXIMUM NUMBER Or PARALLEL LINKS 




3o 


STATION IS ALREADY ATTACHED 




37 


1 IML/M/"MA/M ATTDIDI ITC 

UNKNOWN ATTRIBUTE 




3o 


ATTDIDI ITC IC M/"YT OCTTADI C 

ATTRIBUTE IS NOT SETTABLE 




39 


II 1 C/"*AI ATTDIDI ITC WAI 1 IC 

ILLEGAL ATTRIBUTE VALUE 




40 


INITIALIZATION SEQUENCE OUT OF PHASE 




41 


INCOMPATIBLE ROUTER PROTOCOL LEVEL 




42 


SOURCE NODE UNREACHABLE 




43 


NODE IS A NEIGHBOR 




44 


NODE IS UNKNOWN 




45 


INVALID FRAME LENGTH 




46 


NETWORK IS CLOSING 




47 


STATION NOT ATTACHED 




Table 12-69. Station-Level Reason Codes 


Number 


Description 




1 


CONNECTION PORT DIALOG ALREADY OPEN 




2 


CONNECTION PORT DIALOG ALREADY CLOSED 




3 


CONNECTION PORT DIALOG PENDING OPEN 




4 


CONNECTION PORT DIALOG PENDING CLOSED 




5 


STATION DIALOG NOT CLOSED 




6 


CONNECTION PORT DIALOG NOT OPEN 




7 


STATION DIALOG NOT OPEN 




8 


STATION DIALOG ALREADY CLOSED 




9 


STATION DIALOG PENDING OPEN 




10 


STATION DIALOG PENDING CLOSED 




11 


CONNECTION PORT INVALID STATE 
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Table 12-69. Station-Level Reason Codes (cont.) 



iNUmDer 


uesciipuon 




12 


DSR RESPONSE TIMER TIMEOUT 




13 


CTS RESPONSE TIMER TIMEOUT 




14 


UNEXPECTED DSR OFF 




15 


UNEXPECTED CTS OFF 




16 


DCD OFF DELAY TIMER TIMEOUT 




17 


r\i a i i lAMrM rn iki\/ai ir\ r>T att 

DIAL HANDLER INVALID STATE 




18 


NO TELEPHONE NUMBER 




19 


UNEXPECTED PWI OFF 




20 


UNEXPECTED COS ON 




21 


UNEXPECTED DLO OFF 




22 


a /*m i nrAnAMAr Tinrn tiiitai it 

ACU RESPONSE TIMER TIMEOUT 




23 


ACR ON 




24 


RETRY COMPLETED 




25 


Tr\/T T/-\/"*v ■ At |A 

TEXT TOO LONG 




26 


CONNECTION PORT DIALOG CLOSED 




27 


TEST SENDER NOT RESET 




28 


FRMR RECEIVED 




on 


dctdv f»ni imt cvpccnrn cod oadm 
KtlKY UUUINI tAUttUtD rUK bAbM 




on 
oU 


UM KLULIVLU 




•3 1 


nioo i dfpfiwfh 




QO 


nicn o pfpfix/fh 

UloU-£ nLULlVLU 




oo 


HIAI RFCPHNIQF TIMFR TIMFHI IT 
UIAL ntorUINot 1 IIVILrt 1 llVltUU 1 






PFTPV POIIMT FYPFFHFn FOP niQP 
Ktlni UUUINI LAULLULU rUK UloU 




do 


r-KtbrUINot IIMtK IIMtUUI 




36 


NO NAME, VALUE 




37 


NO NAME 




38 


COMMAND NOT IMPLEMENTED 




39 


INVALID 




40 


CURRENT STATE OF CPDS-1 




41 


SYSTEM HAS NO SHARED GLOBAL MEMORY 




42 


INSUFFICIENT SHARED GLOBAL MEMORY 
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Table 12-69. Station-Level Reason Codes (cont.) 



Number 


Description 


43 


CLOSE STATION DIALOG RECEIVED 


44 


STATION-LEVEL SOFTWARE FAILURE 


45 


DCWRITE ERROR 


46 


SLM SENDER NOT RESET 


47 


CP DIALOG PEND/OPEN, PEND/CLOSED 


48 


NSP (DCC) DSED 


49 


DATA COM M ERROR 


50 


STATION DIALOG ALREADY OPEN 


51 


RETRY COUNT EXCEEDED 


52 


UNEXPECTED UA RECEIVED 


53 


STATION LOST CARRIER 


54 


GMM FRAME XMIT FAILED 

\JIVIIVI 1 lA^IVIL. /\IVll 1 1 rMLLL/ 


55 


UNEXPECTED DM RECEIVED 


56 


ILLEGAL GMM STATION 

1 LLLuHL V_J 1 VI 1 VI Olnl Iwll 




RFTRY POIINT FXPFFOFD FDR FRMR 


JO 


UNFXPEPTED F— 1 RECFIVFD 


59 


DATAPOMM ADAPTFR FA1IIT 


60 


RP DRP1 RFPFIVFD 


fil 

U J. 


KP RFTRY POIINT FXPFFDFD FOR 1 R 


6? 


RP UNFXP UA RECFIVFD 

lOu Ul lUAl Un FA l_v>L. 1 V LL/ 




RP MOOF NOT OPFN 


64 


RP ^TA DIAI OR PI O^FD 


65 


ISC HUB INITIALIZATION FAILED 


66 


ISC FATAL HC ERROR 


67 


ISC HUB MANAGER DSED 


68 


ISC UNEXPECTED SD CLOSE 


69 


ISC LOCAL HC ERROR 


70 


REMOTE HOST UNRESPONSIVE 


71 


CP CLOSED AT REMOTE HOST 


72 


ISC REMOTE HC ERROR 


73 


ISCUPDATEPATHS ERROR 
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Table 12-69. Station-Level Reason Codes (cont.) 



Number 


Description 




74 


ACTIVE STATION ON HUB TO NEIGHBOR 




75 


REMOTE INCONSISTENT AMR INFO 




76 


RESUME READY 




77 


GLOBAL MEMORY STATION ENGAGED 




78 


STATION GROUP NOT OPEN 




Table 12-70. Station-Level Reports 


Number 


Description 




1 


STATION DIALOG CLOSED 




2 


CONNECTION PORT DIALOG CLOSED 




3 


TEST COMMAND RECEIVED 




4 


FRAME RECEIVED (SLM) 




5 


INCOMING CALL 




6 


AWAIT CARRIER 




7 


1 RESPONSE RECEIVED 




8 


CP DIALOG OPEN/CLOSED 




9 


INVALID BDLC ADDRESS 




10 


BDLC FRAME RECEIVED NOT OCTET MULTIPLE 




11 


BDLC FRAME TOO SHORT 




12 


UNEXPECTED CP DIALOG CLOSED 




13 


NON BNA VERSION 1 CALLER 




14 


LINK RESET LOCALLY 




15 


FRAME REJECT RECEIVED 




16 


RETRY COUNT EXCEEDED (OSD) 




17 


LINK RESET REMOTELY 




18 


FRAME REJECT SENT 




19 


UNEXPECTED DM/DISC RECEIVED 




20 


STATION DIALOG REOPENED 




21 


REQUEUE UNACK FRAME ERROR 
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Table 12-70. Station-Level Reports (cont.) 



Number 


Description 




22 


FRAME TRANSMISSION ERROR 




23 


STATION ATTACH ERROR 




24 


REMOTE BUSY SET 




25 


REMOTE BUSY RESET 




26 


DM RECEIVED(OSD) 




27 


DISC RECEIVED(OSD) 




28 


MSG SIZE EXCEEDS CB AREA 




29 


BDLC FRAME NOT OCTET MULTIPLE (NO FRAME) 




30 


BDLC FRAME TOO LONG 




31 


PENDING RECV LR 




32 


ISC SHUTDOWN IN PROGRESS 




33 


X.25 PVC STATION AWAITING OPEN 




34 


ERROR 




35 


RECEIVED ROUTER LIU 




36 


RECEIVED RESTART 




37 


DIAGNOSTIC PACKET 




38 


CLEAR INDICATION RECEIVED 




39 


RETURN REQUESTED BY 01 




40 


QUERY TIMER EXPIRED 




41 


MAX INFO SIZE FIELD INCOMPATIBLE 




42 


SCM UNABLE TO CONTINUE 




43 


NO TARGET DIRECTORY ENTRY FOUND 




44 


PORT FILE WRITE ERROR 




45 


SUBFILE DEACTIVATED 




46 


GO AWAY RECEIVED 




47 


NO ALLC AVAILABLE FOR TARGETS 




48 


SCM ERROR 




49 


ALLC TIMER EXPIRED 




50 


INVALID DLL ID FRAME 




51 


UNRECOGNIZED ALLC FRAME 




52 


NOTASKAVAILABLE 
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Table 12-70. Station-Level Reports (cont.) 



Number 


Description 




53 


OPENPORTTOALLCFAILURE 




54 


ALLCPORTBLOCKED 




55 


NEGATIVERESPONSETOOSD 




56 


AWAIT DATA SET READY 




Table 12-71. Station Types 


Number 


Description 




1 


BDLC DEDICATED 




2 


BDLC SWITCHED WITH ACU 




3 


BDLC SWITCHED WITHOUT ACU 




4 


X.25 GROUP 




5 


X.25 VC 




6 


X.25 PVC 




7 


ISC GROUP 




8 


ISC STATION 




9 


GLOBAL MEMORY 




10 


BLDC SWITCHED MANUAL 




Table 12-72. X-25 PDNs 


Number 


Description 




0 


NULL 




1 


DATAPAC 




2 


TRANSPAC 




3 


DDX 




4 


PSS 




5 


TELENET 




6 


TYMNET 




7 


INFOSWITCH 
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Table 12-72. X-25 PDNs (cont.) 



Number 


Description 


8 


DATANET-1 


9 


DATEX-PIO 


10 


SAPONET 


11 


SCT 


12 


TELEPAC 


13 


BX.25 


14 


RETD 


15 


RTTX.25 


16 


AUSTPAC 



The log entries in Table 12-73, "Major Type 11-Minor Types 1 through 4," are written 
when the value of a BNA Version 1 attribute is set by an operator command. The four 
types of log entries correspond to four different BNA Version 1 modules. These entries 
are written only when the LOGGING attribute is set to at least the value STANDARD. 



Table 12-73. Major Type 11-Minor Types 1 through 4 


Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 Set Network-Services-Manager (NSM) Attribute (LOGNSMATT) 

2 Set Port-Level-Manager (PLM) Attribute (LOGPLMATT) 

3 Set Router Attribute (LOGROUTATT) 

4 Set Station-Level-Manager (SLM) Attribute (LOGSLMATT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to attribute name (bytes) 


5 


Attribute value 

[47: 2] Attribute type 

0 = INTEGER 

1 = STRING 

2 = BOOLEAN 
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Table 12-73. Major Type 11 -Minor Types 1 through 4 (cont.) 



Minor Type 
Minor Type 

Minor Type 


= 1 Set Network-Services-Manager (NSM) Attribute (LOGNSMATT) 
= 2 Set Port-Level-Manager (PLM) Attribute (LOGPLMATT) 

= 3 Spt Router Attribute fl OGROUTATn 

= 4 Set Station-Level-Manager (SLM) Attribute (LOGSLMATT) 


Words 


Description 




[39:40] LINK to attribute value. 




The length of string-valued attributes is in bytes; other attributes are stored 
in one word. 


6 


For Minor Types 1, 3, and 4, this word is reserved. For Minor Type 2, this 
word holds a network services (NS) error code. 


7-end 


Variable-length data pointed to by the LINK in this entry 



For more information, see Table 12-67, "NS Error Codes." 



The log entry described in Table 12-74, "Major Type 11-Minor Type 5," is written 
when the phase of the NSM changes during network initialization and when the 
network is shutting down. 



Table 12-74. Major Type 11-Minor Type 5 



Minor Type = 


5 Network Services Manager Phase Change (LOGNSMPHASE) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


New Phase 

2 = STARTNET 

3 = DATA-ENTRY 

4 = WAIT-STATION 

5 = WAIT-ROUTER 

6 = WAIT-PORT 
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Table 12-74. Major Type 11-Minor Type 5 (cont.) 



Minor Type = 


5 Network Services Manager Phase Change (LOGNSMPHASE) 


Words 


Description 




7 = NORMAL-OPERATION 




11 = SLOW-SHUTDOWN 




12 = FAST-SHUTDOWN 




13 = ROUTER-SHUTDOWN 




14 = STATION-SHUTDOWN 



The log entries in Table 12-75, "Major Type 11-Minor Types 6 and 7," are written 
when remote nodes and hosts are added to BNA Version 1 tables. Nodes and hosts can 
be added in response to operator commands, or can be added automatically as the local 
node learns of the existence of other nodes and hosts in the network. These entries are 
written only when the LOGGING attribute is set to at least the value STANDAED. 



Table 12-75. Major Type 1 1 -Minor Types 6 and 7 



Minor Type = 
Minor Type = 


6 Add Host (LOGADDHOST) 

7 Add Node (LOGADDNODE) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


LINK to hostname (bytes) 




5 


Host information: 
[33: 1] Reachability 

0 = Not reachable 

1 = Reachable 

[32: 1] Translate-only flag 
[31:16] Port maximum segment size 
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Table 12-75. Major Type 11-Minor Types 6 and 7 (cont.) 



Minor Type = 


6 Add Host (LOGAODHOST) 


Minor Type = 


7 Add Node (LOGADONODE) 


Words 


Description 




[15:16] Node address 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINK in this entry 



The log entry in Table 12-76, "Major Type 11-Minor Type 8," is written when a 
remote host is cleared, saved, or made ready in response to the corresponding operator 
command. This entry is written only when the LOGGING attribute is set to at least 
the value STANDARD. 



Table 12-76. Major Type 1 1 -Minor Type 8 



Minor Type = 


8 Host Status (LOGHOSTSTAT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to hostname (bytes) 


5 


Host status: 




[ 1: 2] Request 




0 = Save host 




1 = Ready host 




2 = Clear host 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINK in this entry 
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The log entries in Table 12-77, "Major Type 11-Minor Types 9 and 10," are written 
when remote nodes and hosts are deleted from BNA Version 1 tables. Nodes and hosts 
are deleted in response to the DELETE HOST or DELETE NODE operator command. 
These log entries are written only when the LOGGING attribute is set to at least the 
value STANDARD. 



Table 12-77. Major Type 11-Minor Types 9 and 10 



Minor Type = 


9 Delete Host (LOGDELHOST) 


Minor Type = 


10 Delete Node (Lugdelnode) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to hostname (bytes) 


5 


Host information: 




[16: 1] Name translation 




0 = Host name deleted 




1 = Host name retained for address translation only 




[15:16] Node address 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINK in this entry 



) 
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The log entry in Table 12-78, "Major Type 11-Minor Type 11," is written when the 
port-level-manager (PLM) module detects an error, especially in an incoming port 
frame. This entry is written only when the LOGGING attribute is set to at least the 
value STANDARD. 



Table 12-78. Major Type 1 1-Minor Type 1 1 



Minor Type = 


11 Port-Level-Manager (PLM) Error Report (LOGPLMERR) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Reserved 


5 


LINK to error report (bytes) 


6-end 


Variable-length data pointed to by the LINK in this entry 



The log entry in Table 12-79, "Major Type 11-Minor Type 12," is written when the 
port-level-manager (PLM) module detects certain conditions and events. These are 
described below. This entry is written only when the LOGGING attribute is set to at 
least the value STANDARD. 

Table 12-79. Major Type 1 1-Minor Type 12 



Minor Type = 


12 Port-Level-Manager (PLM) Log Report (LOGPLMRPT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Report information 




[31:16] Report type 




Only one of the bits in this field can be set. It shows the type of PLM 




report. 




[21: 1] PLM-ID frame sent 




[20: 1] Received ACCEPT match frame for nonexistent port 




[19: 1] Received port frame larger than maximum segment size 




[18: 1] Valid PLM-ID frame received 
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Table 12-79. Major Type 11-Minor Type 12 (cont.) 



Minor Type = 


12 Port-Level-Manager (PLM) Log Report (LOGPLMRPT) 




Words 


Description 






[17: 1] PLM dialog terminated 






[16: 1] PLM dialog established 






[15:16] Remote node address 




The format of the remainder of the entry depends on the report type. 




PLM dialog established and PLM dialog terminated: 




5 


LINK to remote host name (bytes) 




6 


Local subport index 




7 


PLM dialog termination reason 






(Dialog termination report only) 






1 = Inactivity 






2 = Inactivity: network shutdown 






3 = Inactivity: host saved 






4 = Host deleted 






5 = Loss of validation 






6 = Inactivity requested 






7 = Demand received 






8 = Deactivation 






9 = Failure to establish PLM dialog 




8-end 


Variable-length data pointed to by the LINK in this entry 




Valid PLM-ID frame received: 




5 


LINK to remote host name (bytes) 




6 


LINK to remote incarnation ID (bytes) 




7-end 


Variable-length data pointed to by the LINKs in this entry 




ACCEPT frame for nonexistent port: 




5 


LINK to text of ACCEPT frame (bytes) 
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Table 12-79. Major Type 1 1-Minor Type 12 (cont.) 


Minor Type = 


12 Port-Level-Manager (PLM) Log Report (LOGPLMRPT) 


Words 


Description 


6-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-80, "Major Type 1 1-Minor Type 13," is written when the 
resistance factor to a neighbor node is changed in response to the LINKRF operator 
command. It is also written when the node resistance factor used at the local node is 
changed in response to the NODERF operator command. This entry is written only 
when the LOGGING attribute is set to at least the value STANDARD. 



Table 12-80. Major Type 1 1-Minor Type 13 



Minor Type = 


13 Resistance Factor Change (LOGROUTRFCHG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Node address (zero indicates local node) 


5 


Resistance factor 


6 


Network services manager (NSM) error code (See Table 12-68, "NSM Error 
Codes.") 
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The log entry in Table 12-81, "Major Type 11-Minor Type 14," is written when a 
Routing Trace message is sent to a remote node in response to the STARTTRACE 
operator command. This entry is written only when the LOGGING attribute is set to 
the value MAXIMUM. 



Table 12-81. Major Type 11-Minor Type 14 



Minor Type = 


14 Start Trace (LOGROUTSTTRA) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Trace source node address 


5 


Trace destination node address 


6 


Trace reference 


7 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 



The log entry in Table 12-82, "Major Type 11-Minor Type 15," is written when the 
Routing Refresh function is performed in response to the ROUTINGREFRESH 
operator command. This entry is written only when the LOGGING attribute is set to 
the value MAXIMUM. 

Table 12-82. Major Type 11-Minor Type 15 



Minor Type =15 Routing Refresh (LOGROUTREFRESH) 
Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

(No additional fields) 
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The log entries in Table 12-83, "Major Type 11-Minor Types 16 and 17," are written 
when router control frames are sent and received by the local node. Router control 
frames include LINKCHANGE and NETCHANGE messages that are used to inform 
neighbor nodes about changes in the topology of the network. The Router Control 
Frame Sent (Type 16) entry is written only when the LOGGING attribute is set to the 
value MAXIMUM. The Router Control Frame Received (Type 17) entry is written only 
when the LOGGING attribute is set to at least the value STANDARD. 



Table 12-83. Major Type 11-Minor Types 16 and 17 



Minor Type = 
Minor Type = 


16 Router Control Frame Sent (LOGROUTCFSEND) 

17 Router Control Frame Received (LOGROUTCFRECV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to remote hostname (bytes) 


5 


LINK to text of frame (bytes) 


6-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-84, "Major Type 11-Minor Type 18," is written when the 
Router detects an error in an incoming Router frame. This entry is written only when 
the LOGGING attribute is set to at least the value MINIMUM. 



Table 12-34. Major Type 1 1 -Minor Type 18 



Minor Type = 


18 Router Frame Error (LOGROUTERR) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Destination node address 


5 


Origin node address 


6 


Error information 

[15: 8] Network services manager (NSM) error code (See Table 12-68, 
"NSM Error Codes.") 

[07: 8] Router error type 
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Table 12-84. Major Type 11 -Mi nor Type 18 (cont.) 



Minor Type = 


18 Router Frame Error (LOGROUTERR) 


Words 


Description 




1 = NSM-to-NSM error 




2 = Link-Change error 




3 = Net-Change error 




4 = Trace-Start error 




5 = Trace error 
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7 = Reserved 




8 = Router header error 




9 = Router transit error 


7 


LINK to frame text (bytes) 


8 


LINK to destination host name (bytes) 


9 


LINK to origin host name (bytes) 


10-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-85, "Major Type 11-Minor Type 19," is written when the 
routing status to a remote node in the network changes. The entry is generated when 
at least one of the following routing factors has changed: 

• Reachability 

• Neighbor node address 

• Router and Port maximum segment size (these always change together) 

Other routing factors, such as hop-count and resistance-factor, might also have 
changed. 
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This entry is written only when the LOGGING attribute is set to at least the value 
STANDARD. 

Table 12-85. Major Type 1 1 -Minor Type 19 



Minor Type = 


19 Destination Node Status Change (LOGROUTDNASTAT) 


worus 


uescnpuon 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Destination node address 


5 


Neighbor node address 




This field indicates the neighbor node through which traffic is routed when 




the local node is sending frames to the destination node. 


6 


Routing status information #1 




[47:16] Resistance factor 




[31:16] Port frame maximum segment size 




[15:16] Router frame maximum segment size 


7 


Routing status information #2 




[47:06] Routing status change flags 




0 = Attribute did not change 




1 = Attribute changed 




[47:1] Neighbor node address 




[46:1] Router frame maximum segment size 




[45:1] Port frame maximum segment size 




[44:1] Reachability 




[43:1] Resistance factor 




[42:1] Hop count 




[16: 1] Node reachability 




[15:16] Hop count 


8 


LINK to destination host name (bytes) 


9 


LINK to neighbor host name (bytes) 


10-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-86, "Major Type 11-Minor Type 20," is written for every 
incoming and outgoing Router frame when the COPY option has been set through 
the MONITOR operator command. This entry is written only when the LOGGING 
attribute is set to at least the value MINIMUM. 



Table 12-86. Major Type 11-Minor Type 20 



Minor Type = 


20 Router Monitor Frame Copy (LOGROUTCOPYRPT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Destination node address 


5 


Origin node address 


6 


LINK to frame text (bytes) 


7-end 


Variable-length data pointed to by the LINKs in this entry 


The log entry in Table 12-87, "Major Type 11-Minor Type 21," is written periodically 
only when the TRAFFIC option has been set by the MONITOR operator command. 
The frequency with which this entry is generated is controlled by the Router traffic 
monitor interval, which is also set by the MONITOR command. This entry is written 
only when the LOGGING attribute is set to at least the value MINIMUM. 




Table 12-87. Major Type 1 1-Minor Type 21 


Minor Type = 


21 Router Monitor Traffic Summary (LOGROUTSUMRPT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to traffic summary data (words) 

For more information about Word 4, see the text immediately following this 
table. 


5 


Reserved 


6-end 


Variable-length data pointed to by the LINK in this entry 



The traffic summary data (Word 4) are composed of a series of 7-word entries, each 
containing a summary of the traffic that passed through the local node in transit from 
a particular origin node/destination node pair. Each entry has the following format: 
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( 

Word Contents 

1 Node addresses: zero indicates the local node 

[31:16] destination node 

[15:16] origin node 

2-7 Three entries, each two words in length: the first word in each 

entry shows the number of frames of a particular type, and the 
second word shows the number of bytes of data in those frames. 

2 Number of information frames 

3 Bytes of information data 

4 Number of control frames 

5 Bytes of control data 

6 Number of frames with errors 

7 Bytes of error data 



The log entry in Table 12-88, "Major Type 11-Minor Type 24," is written when the 
Router adds or deletes a node to or from its tables. This can be in response to an ADD 
NODE, DELETE NODE, ADD HOST, or DELETE HOST operator command, or 
in response to information received from other nodes in the network. This entry is 
written only when the LOGGING attribute is set to at least the value STANDARD. 



Table 12-88. Major Type 1 1-Minor Type 24 



Minor Type 


= 24 Router Node Existence (LOGROUTNODEEXIST) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Node information 




[16: 1] Operation 




0 = Add node 




1 = Delete node 




[15:16] Node address 


5 


Network services manager (NSM) error code (See Table 12-68, "NSM Error 




Codes.") 
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The log entry in Table 12-89, "Major Type 11-Minor Type 25," is written when one 
or more attributes of a BNA Version 1 station are modified in response to a MODIFY 
STATION operator command. This entry is written only when the LOGGING attribute 
is set to at least the value STANDARD. 



Table 12-89. Major Type 11-Minor Type 25 



Minor Type = 


25 Modify Station (LOGSLMMODIFYSTA) 




Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


LINK to station name (bytes) 




5 


LINK to attribute list (words) 






Each word in the attribute list has the following structure: 






[47: 8] Station attribute number 






1 = Station-Type 






2 = Hardware-ID 






3 = Autoinit 






4 = Efficiency 






5 = Maximum-Segment-Size 






6 = Speed 






7 = Monitor 






8 = Hub-Number (ISC) 






1 1 = Windowsize (ISC) 






12 = Retry-Count-limit (ISC) 






13 = FRSP-Timer (ISC) 






14 = Checkpoint-Timer (ISC) 






15 = Maximum-Frame-Size (ISC) 






17 = First-PVC (X.25 Group) 






18 = Last-PVC (X.25 Group) 






19 = First-VC-IN (X.25 Group) 






20 = Last-VC-IN (X.25 Group) 






21 = First-VC-IO (X.25 Group) 






22 = Last-VC-IO (X.25 Group) 




continued 
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Table 12-89. Major Type 11-Minor Type 25 (cont.) 



Minor Type 


= 25 Modify Station (LOGSLMMODI FYSTA) 


Words 


Description 




23 = First-VC-OUT (X.25 Group) 




24 = Last-VC-OUT (X.25 Group) 




25 = Restart-Retry-Count-Limit (X.25 Group) 
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28 = Timer-Limit-Value-T32 (X.25 Station) 




29 = Timer-Limit-Value-T33 (X.25 Station) 




30 = LC-Retry-Count-Limit-1 (X.25 Station) 




31 = LC-Retry-Count-Limit-2 (X.25 Station) 




32 = LC-Local-Window-Size (X.25 Station) 




33 = LC-Packet-Size (X.25 Station) 




34 = Public-Data-Network (X.25 Group) 




on _ Mnriifipri (Y 95 Grnnn} 
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[39:40] Attribute value 




All attributes are integer valued except for the following: 




Station type (#1): enumerated (See Table 12-71, "Station Types.") 




Autoinit (#3): Boolean 




0 = FALSE 




1 = TRUE 




Monitor (#7): enumerated 




0 = OFF 




1 = ON 




Public Data Network (#34): enumerated (See Table 12-72, "X-25 
PDNs.") 




Modified (#35): Boolean 




0 = FALSE 


continued 
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Table 12-89. Major Type 11 -Minor Type 25 (cont.) 



Minor Type = 


25 Modify Station (LOGSLMMODI FYSTA) 


Words 


Description 




1 = TRUE 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINKs in this entry 


The log entry in Table 12-90, "Major Type 11-Minor Type 26," is written when a BNA 
Version 1 station is deleted in response to a DELETE STATION operator command. 
This entry is written only when the LOGGING attribute is set to at least the value 
STANDARD. 




Table 12-90. Major Type 1 1 -Minor Type 26 


Minor Type = 


26 Delete Station (LOGSLMDELSTA) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Reserved 


6 


Network services (NS) error code 


7-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-91, "Major Type 11-Minor Type 27," is written when an 
ensemble of BNA Version 1 stations is created in response to an ADD ENSEMBLE 
operator command. This entry is written only when the LOGGING attribute is set to 
at least the value STANDARD. 



Table 1 2-9 1 . Major Type 1 1-M inor Type 27 



Minor Type = 


27 Add Ensemble (LOGSLMADDENS) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to ensemble name (bytes) 


5 


Direction 

1 = PERMANENT 

2 = INCOMING 

3 = OUTGOING 


6 


LINK to station list (words) 

Each entry in the list is composed of a 1-byte field showing the length (in 
bytes) of the station name, followed by the name, and (if needed) filler to a 
word boundary. 


7 


Network services (NS) error code 


8-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-92, "Major Type 11-Minor Type 28," is written when one or 
more BNA Version 1 stations are added to, or deleted from, an ensemble in response 
to a MODIFY ENSEMBLE operator command. This entry is written only when the 
LOGGING attribute is set to at least the value STANDARD. 



Table 12-92. Major Type 1 1 -Minor Type 28 



Minor Type = 


28 Modify Ensemble (LOGSLMMODIFYENS) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to ensemble name (bytes) 


5 


Add or delete flag 




0 = Delete stations 




1 = Add stations 


6 


LINK to station list (words) 




Each entry in the list is composed of a 1-byte field showing the length (in 




bytes) of the station name, followed by the name, and (if needed) filler to a 




word boundary. 


7 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


8-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-93, "Major Type 11-Minor Type 29," is written when an 
ensemble of BNA Version 1 stations is deleted in response to a DELETE ENSEMBLE 
operator command. This entry is written only when the LOGGING attribute is set to 
at least the value STANDARD. 



Table 12-93. Major Type 11-Minor Type 29 


Minor Type = 


29 Delete Ensemble (LOGSLMDELENS) 




Words 


Description 




0-3 

4 

5 


As described in Table 12-2, "First Four Log Entry Words" 

LINK to ensemble name (bytes) 

Reserved 




continued 
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Table 12-93. Major Type 1 1 -Minor Type 29 (cont.) 


Minor Type = 


29 Delete Ensemble (LOGSLMDELENS) 


Words 


Description 


6 


Reserved 


7 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


8-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-94, "Major Type 11-Minor Types 30 and 31," is written when 
the description of a connection to a neighbor node is added or modified in response to 
an ADD CONNECTION or MODIFY CONNECTION operator command. This entry is 
written only when the LOGGING attribute is set to at least the value STANDARD. 



Table 12-94. Major Type 11-Minor Types 30 and 31 



Minor Type 


= 30 Add Connection (LOGSLMADDCONN) 


Minor Type 


= 31 Modify Connection (LOGSLMMODI FYCONN) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Neighbor node address 


5 


Direction 




1 = PERMANENT 




2 = INCOMING 




3 = OUTGOING 


6 


Station/ensemble name 




[47: 1] Station or ensemble 




0 = Ensemble name 




1 = Station name 




[39:40] LINK to name (bytes) 
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Table 12-94. Major Type 11-Minor Types 30 and 31 (cont.) 



Minor Type = 
Minor Type = 


30 Add Connection (LOGSLMADDCONN) 
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31 Modify Connection (LOGSLMMODIFYCONN) 


Words 


Description 


7 


LINK to CALLDATA (bytes) (OUTGOING only) 


8 


INITQUANTITY (OUTGOING only) 

The value -1 represents an empty field; that is, the command did not cause 
the value of INITQUANTITY to be set. 


9 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


10 


LINK to neighbor host name (bytes) 


11-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-95, "Major Type 11-Minor Type 32," is written when the 
description of a connection to a neighbor node is deleted in response to a DELETE 
CONNECTION operator command. This entry is written only when the LOGGING 
attribute is set to at least the value STANDARD. 



Table 12-95. Major Type 1 1 -Minor Type 32 



Minor Type = 


32 Delete Connection (LOGSLMDELCONN) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Neighbor node address 


5 


Direction 




1 = PERMANENT 




2 = INCOMING 




3 = OUTGOING 


6 


Station/ensemble name 



continued 
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Table 12-95. Major Type 11-Minor Type 32 (cont.) 



Minor Type 


= 32 Delete Connection (LOGSLMDELCONN) 


Words 


Description 




[47: 1] Station or ensemble 




0 = Ensemble name 




1 = Station name 




[39:40] LINK to name (bytes) 


7 


Reserved 


8 


Reserved 


9 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


10 


LINK to neighbor host name (bytes) 


11-end 


Variable-length data pointed to by the LINK in this entry 



The log entry in Table 12-96, "Major Type 11-Minor Type 33," is written when one 
or more BNA Version 1 stations are closed upon receipt of a CLEARCALL operator 
command. The information in the entry shows whether the command requested that a 
particular station be cleared or if the command specified an ensemble of stations or 
neighbor node. This entry is written only when the LOGGING attribute is set to at 
least the value STANDARD. 



Table 12-96. Major Type 1 1-Minor Type 33 



Minor Type 


= 33 Clear Call (LOGSLMCLEARCALL) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Neighbor node address 


5 


Station/ensemble name 




[47: 1] Station or ensemble 
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Table 12-96. Major Type 11-Minor Type 33 (cont.) 



Minor Type 


— jj uiear uaii ilu(jolivil.llakuall) 
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0 = Ensemble name 




1 = Station name 




[39:40] LINK to name (bytes) 


6 


Reserved 


7 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


8-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-97, "Major Type 11-Minor Type 34," is written when one or 
more BNA Version 1 stations are opened upon receipt of an ESTABLISHCALL operator 
command. The information in the entry shows whether the command requested that 
a particular station be opened or if the command specified an ensemble of stations. 
This entry is written only when the LOGGING attribute is set to at least the value 
STANDARD. 



Table 12-97. Major Type 11-Minor Type 34 



Minor Type 


= 34 Establish Call (LOGSLMESTCALL) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Neighbor node address 


5 


Station/ensemble name 




[47: 1] Station or ensemble 




0 = Ensemble name 




1 = Station name 




[39:40] LINK to name (bytes) 



continued 



8600 0478-100 



12-245 



SUMLOG 



Table 12-97. Major Type 11-Minor Type 34 (cont.) 


Minor Type 


= 34 Establish Call (LOGSLMESTCALL) 


Words 


Description 


6 


LINK to CALLDATA (bytes) 


7 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


8-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-98, "Major Type 11-Minor Type 35," is written when one 
or more BNA Version 1 stations are opened upon receipt of an AWAITCALL operator 
command. The information in the entry shows whether the command requested that 
a particular station be opened or if the command specified an ensemble of stations. 
This entry is written only when the LOGGING attribute is set to at least the value 
STANDARD. 



Table 12-98. Major Type 1 1 -Minor Type 35 



Minor Type = 


35 Await Call (LOGSLMAWAITCALL) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Station/ensemble name 




[47: 1] Station or ensemble 




0 = Ensemble name 




1 = Station name 




[39:40] LINK to name (bytes) 


5 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


6-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-99, "Major Type 11-Minor Type 36," is written when a 
test frame is sent on a BNA Version 1 station in response to a SENDTEST operator 
command. This entry is written only when the LOGGING attribute is set to the value 
MAXIMUM. 



Table 12-99. Major Type 11-Minor Type 36 



Minor Type = 


36 Send Test (LOGSLMSENDTEST) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


LINK to text (bytes) 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINKs in this entry 



The log entries in Table 12-100, "Major Type 11-Minor Types 37 and 38," are written 
when a test frame or test response frame is received on a BNA Version 1 station. These 
entries are written only when the LOGGING attribute is set to the value MAXIMUM. 



Table 12-100. Major Type 1 1 -Minor Types 37 and 38 



Minor Type = 
Minor Type = 


37 Test Received (LOGTESTCOMMRECV) 

38 Test Response Received (LOGTESTRESPRECV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


LINK to text (bytes) 


6-end 


Variable-length data pointed to by the LINKs in this entry 
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Table 12-101. Major Type 11-Minor Type 39 



Minor Type = 39 Link Reset (LOGSLMLI NKRESET) 
Words Description 

This log-entry type is not currently used. 



The log entry in Table 12-102, "Major Type 11-Minor Type 40," is written when an 
Open-Connection-Port-Dialog command is sent to a BNA Version 1 station. This 
command is a manual BNA Version 1 used to control the opening of a station. It can 
also be initiated by the operator command ESTABLISHCALL or AWAITCALL, or by 
setting the AUTOINIT attribute for that station. This entry is written only when the 
LOGGING attribute is set to at least the value STANDARD. 



Table 12-102. Major Type 11-Minor Type 40 



Minor Type 


= 40 Open Connection Port (LOGSLMOPENCPD) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


LINK to CALLDATA (bytes) 


6 


Station-level reason code (See Table 12-69, "Station-Level Reason 
Codes.") 


7-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-103, "Major Type 11-Minor Type 41," is written when a 
Close-Connection-Port-Dialog command is sent to a BNA Version 1 station. This 
command is a manual BNA Version 1 command used to control the closing of a station. 
It can also be initiated by the CLEARCALL operator command, and by the shutdown 
of the network. This entry is written only when the LOGGING attribute is set to at 
least the value STANDARD. 



Table 12-103. Major Type 1 1-Minor Type 41 



Minor Type 


= 41 Close Connection Port (LOGSLMCLOSECPD) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Station-level reason code (See Table 12-69, "Station-Level Reason 
Codes.") 


6-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-104, "Major Type 11-Minor Type 42," is written when a 
VALID ATE AND ATTACH operator command is received for a BNA Version 1 station. 
It indicates that the operator, who is opening the station manually, wants BNA Version 
1 to initiate the exchange of station-level greetings with the remote node. If successful, 
the station is attached to the Router level at the local node and the station becomes 
operational. This entry is written only when the LOGGING attribute is set to at least 
the value STANDARD. 



Table 12-104. Major Type 11-Minor Type 42 



Minor Type 


= 42 Validate and Attach Station (LOGSLMVALATT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


6-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-105, "Major Type 11-Minor Type 43," is written when a 
DETACH operator command is received for a BNA Version 1 station. It indicates that 
the operator, who is manually closing the station, wants BNA Version 1 to detach the 
station from the Router and close the Station Dialog with the remote node. This entry 
is written only when the LOGGING attribute is set to at least the value MINIMUM. 



Table 12-105. Major Type 1 1 -Minor Type 43 



Minor Type 


= 43 Detach Station (LOGSLMMANDETACH) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


6-end 


Variable-length data pointed to by the LINKs in this entry 



The log entries in Table 12-106, "Major Type 11-Minor Types 44 and 45," are written 
when a SAVE STATION or READY STATION operator command is received for a BNA 
Version 1 station. It indicates that the operator wants BNA Version 1 to make the 
station SAVED or READY, respectively. This entry is written only when the LOGGING 
attribute is set to at least the value STANDARD. 



Table 12-106. Major Type 1 1 -Minor Types 44 and 45 



Minor Type 
Minor Type 


= 44 Save Station (LOGSLMSAVESTA) 
= 45 Ready Station (LOGSLMREADYSTA) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


6-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-107, "Major Type 11-Minor Type 46," is written when an 
Open-Station-Dialog command is sent to a BNA Version 1 station. This is a manual 
BNA Version 1 command used to control the opening of stations. It can also be initiated 
by the ESTABLISHCALL or AWAITCALL operator commands. This entry is written 
only when the LOGGING attribute is set to at least the value STANDARD. 



Table 12-107. Major Type 11-Minor Type 46 



Minor Type = 


46 Open Station Dialog (LOGSLMOPENSD) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Call data value 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINKs in this entry 


The log entry in Table 12-108, "Major Type 11-Minor Type 47," is written when a 
Close-Station-Dialog command is sent to a BNA Version 1 station. This command is a 
manual BNA Version 1 command used to control the closing of stations. It can also be 
initiated by the CLEARCALL operator command. These entries are written only when 
the LOGGING attribute is set to at least the value STANDARD. 




Table 12-108. Major Type 1 1 -Minor Type 47 


Minor Type = 


47 Close Station Dialog (LOGSLMCLOSESD) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


6-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-109, "Major Type 11-Minor Type 48," is written to report 
that a BNA Version 1 station has successfully initialized a link and is now operational. 
It is generated after the station exchanges station-level greetings with the remote node 
and attaches to the Router level at the local node. This entry is also generated when 
a station successfully reinitializes a link after a Link-Reset condition. This entry is 
written only when the LOGGING attribute is set to at least the value MINIMUM. 



Table 12-109. Major Type 11-Minor Type 48 



Minor Type 


= 48 Station Attach Report (LOGSLMATTACH) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Neighbor node address 


6 


Public Data Network ID (X.25) 


7 


Link information: 




[47: 8] Link efficiency 




[39:24] Link speed 




[15:16] Working link maximum segment size 


8 


LINK tG neighbor host name (bytes) 


9-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-110, "Major Type 11-Minor Type 49," is written to report 
that a BNA Version 1 station has detached from the Router level at the local node and 
is no longer operational. This occurrence generally indicates that the station is about 
to be closed. This entry is written only when the LOGGING attribute is set to at least 
the value MINIMUM. 



Table 12-1 10. Major Type 1 1 -Mi nor Type 49 



Minor Type 


= 49 Station Detach Report (LOGSLMDETACH) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Neighbor node address 


6 


LINK to neighbor host name (bytes) 


7-end 


Variable-length data pointed to by the LINKs in this entry 



Table 12-1 11. Major Type 1 1-Minor Type 50 



Minor Type = 50 Neighbor Restart (LOGSLMNEI RESTART) 
Words Description 

This log-entry type is not currently used. 



Table 12-1 12. Major Type 1 1-Minor Type 51 



Minor Type = 51 Neighbor Busy (LOGSLMNEI BUSY) 
Words Description 

This log-entry type is not currently used. 
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The log entry in Table 12-113, "Major Type 11-Minor Type 52," is written to report 
that BNA Version 1 has detected one of a certain set of conditions on a particular 
station. The various conditions that can be detected are listed in Table 12-70, 
"Station-Level Reports." This entry is written only when the LOGGING attribute is 
set to at least the value STANDARD. 



Table 12-1 13. Major Type 1 1-Minor Type 52 



Minor Type = 


52 Station Log Report (LOGSLMLOGRPT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Neighbor node address 


6 


Report information: 




[47: 1] Reserved 




[46: 1] Validity of data link control (BDLC) address and control fields (see 




below) 




0 = BDLC fields not present 




1 = BDLC fields present 




[45: 6] Reserved 




[39: 8] Station Type (See Table 12-71 , "Station Types.") 




[31: 8] BDLC address field 




[23: 8] BDLC control field 




[15: 8] Reserved 




[ 7: 8] Station-level report (See Table 12-70, "Station-Level Reports.") 


7 


LINK to report text (bytes) 


8 


Station-level reason code (See Table 12-69, "Station-Level Reason 




Codes.") 


9 


Public Data Network (X.25) (See Table 12-72, "X-25 PDNs.") 


10-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-114, "Major Type 11-Minor Type 53," is written to report 
that a BNA Version 1 station has failed the exchange of station-level greetings. This 
exchange is part of the initialization process when opening a station and making it 
operational. This entry is written only when the LOGGING attribute is set to at least 
the value MINIMUM. 



Table 12-1 14. Major Type 11-Minor Type 53 



Minor Type = 


53 Station Validation Failure (LOGSLMVALFAIL) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 


5 


Neighbor node address 


6 


Local or remote indicator 




0 = Local validation failure 




1 = Remote validation failure 


7 


1 INK tn tpvt nf failpH firpptincr mps^acrp (hvtpO 


8 


Reason for validation failure 




2 = Incompatible Station level 




3 = Network-Version mismatch 




4 = Network-Maximum-Segment-Size mismatch 




5 = Node address validity failure 




6 = Shutdown in progress 




7 = Password mismatch 




8 = Insufficient resources 




9 = Invalid greeting 


9-end 


Variable-length data pointed to by the LINKs in this entry 
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The log entry in Table 12-115, "Major Type 11-Minor Type 54," is written periodically 
when the MONITOR attribute has been set for a particular BNA Version 1 station. The 
MONITOR attribute is set through the MODIFY STATION operator command and 
causes BNA Version 1 to write information to the log file about the amount of traffic 
handled by the specified station and the number of errors incurred. The frequency 
with which this entry is written is controlled by the Station Monitor Interval attribute, 
which is set by the MONITOR operator command. This entry is written only when the 
LOGGING attribute is set to at least the value MINIMUM. 



Table 12-115. Major Type 1 1-Minor Type 54 



Minor Type = 


54 Station Monitor (LOGSLMMONRPT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to station name (bytes) 




Npitrhhnr information 

INCIgllUUI II IIUI 1 1 IcHIUI 1 




[47:32] Public Data Network ID (X.25) (See Table 12-72, "X-25 PDNs.") 




[15:16] Neighbor node address 


c 
D 


Station information 




T23-161 Hardware ID (LSN) 




[ 7: 8] Station Type (See Table 12-71, "Station Types.") 


7 


Total frames sent 


8 


Total frames received 


9 


Info-frames sent (BDLC, ISC) 


10 


FCS failures (BDLC), or link errors (ISC) 


11 


Memory errors (BDLC) 


12 


Short frames (BDLC) 


13 


Total bytes sent 


14 


Total bytes received 


15 


Link information 




[47: 8] Link efficiency 




[39:24] Link speed 




[15:16] Working link maximum segment size 
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Table 12-115. Major Type 1 1 -Minor Type 54 (cont.) 



Minor Type = 


54 Station Monitor (LOGSLMMONRPT) 


Words 


Description 


16 


Reserved 


17 


Total data packets received (for X.25 Station) 


18 


Total data packets sent (for X.25 Station) 


19-end 


Variable-length data pointed to by the LINKs in this entry 



The log entry in Table 12-116, "Major Type 11-Minor Type 55," is written when a 
BNA Version 1 station is added in response to an ADD STATION operator command. 
It is also generated when a BNA Version 1 station is added automatically. For example, 
data link control (BDLC) stations are added automatically by BNA Version 1 when 
certain conditions are met. This entry is written only when the LOGGING attribute is 
set to at least the value STANDARD. 



Table 12-1 16. Major Type 1 1 -Minor Type 55 



Minor Type = 


55 Add Station (LOGSLMADDSTA) 




Words 


Description 




0-3 
4 


As described in Table 12-2, "First Four Log Entry Words" 
LINK to station name (bytes) 




5 


LINK to attribute list (words) 

Each word in the attribute list has the following structure: 
[47: 8] Station attribute number 

1 = Station-Type 

2 = Hardware-ID 

3 = Autoinit 

4 = Efficiency 
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Table 12-116. Major Type 1 1-Minor Type 55 (cont.) 



Minor Type = 55 Add Station (LOGSLMADDSTA) 
Words Description 

5 = Maximum-Segment-Size 

6 = Speed 

7 = Monitor 

8 = Hub-number (ISC) 



11 




Window-Size (ISC) 


12 




Retry-Count-Limit (ISC) 


13 




FRSP-Timer (ISC) 


14 





Checkpoint-Timer (ISC) 


15 





Maximum-Frame-Size (ISC) 


17 


_ 


First-PVC (X.25 Group) 


18 


_ 


Last-PVC (X.25 Group) 


19 


_ 


First-VC-IN (X.25 Group) 


20 


_ 


Last-VC-IN (X.25 Group) 


21 




First-VC-IO (X.25 Group) 


22 




Last-VC-IO (X.25 Group) 


23 




First-VC-OUT (X.25 Group) 


24 




Last-VC-OUT (X.25 Group) 


25 




Restart-Retry-Count-Limit (X.25 Group) 


26 




Restart-Response-Timer-Limit (X.25 Group) 


27 




Timer-Limit-Value-T31 (X.25 Group) 


28 




Timer-Limit-Value-T32 (X.25 Group) 


29 




Timer-Limit-Value-T33 (X.25 Group) 


30 




LC-Retry-Count-Limit-1 (X.25 Group) 


31 




LC-Retry-Count-Limit-2 (X.25 Group) 


32 




LC-Local-Window-Size (X.25 Group) 


33 




LC-Packet-Size (X.25 Group) 
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Table 12-116. Major Type 11-Minor Type 55 (cont.) 



Minor Type = 


55 Add Station (LOGSLMADDSTA) 


Words 


Description 




34 = Public-Data-Network (X.25 Group) 




35 = Modified (X.25 Group) 




41 = Modules (X.25 Group) 




[39:40] Attribute value 




All attributes are integer valued except the following: 




Station type (#1): enumerated (See Table 12-71, "Station Types.") 




Autoinit (#3): Boolean 




0 = FALSE 




1 = TRUE 




Monitor (#7): enumerated 




0 = OFF 




1 = ON 




Public Data Network (#34): enumerated (See Table 12-72, "X-25 
PDNs.") 




Modified (#35): Boolean 




0 = FALSE 




1 = TRUE 


6 


Network services (NS) error code (See Table 12-67, "NS Error Codes.") 


7-end 


Variable-length data pointed to by the LINKs in this entry 
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i 

The log entry in Table 12-117, "Major Type 11-Minor Type 56," is written when a 
BNA Version 1 operator command is entered from any one of a number of agents. It is 
also written when a response is sent to the operator. This entry is written only when 
the LOGGING attribute is set to at least the value MINIMUM. 



Table 12-1 17. Major Type 1 1-Minor Type 56 



Minor Type = 


56 Operator Message (LOGNWOIM) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Origin of message 




0 = Unknown source 




1 = ODT 




2 = Remote terminal 




3 = Command file 




4 = Operator response 


5 


LINK to text of message (bytes) 


6-end 


Variable-length data pointed to by the LINKs in this entry 


Table 12-118. Major Type 11-Minor Type 57 


Minor Type = 


57 Operator Initiated Assign (LOGSCMOIASSIGN) 


Words 


Description 


This log entry type is not currently used. 
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Table 12-119. Major Type 11 -Minor Type 58 



Minor Type = 58 SCM Return (LOGSCMRETURN) 
Words Description 

This log-entry type is not currently used. 



Table 12-120. Major Type 11-Minor Type 59 



Minor Type = 59 Target Initiated Assign (LOGTRGASSIGN) 
Words Description 

This log-entry type is not currently used. 



Table 12-121. Major Type 1 1-Minor Type 60 



Minor Type = 60 SCM Frame Receive (LOGSCMFRAMERECV) 
Words Description 

This log-entry type is not currently used. 
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The log entry in Table 12-122, "Major Type 11-Minor Type 61," is for various types of 
BNA Version 1 bug information that occasionally need to be logged. This information is 
for use by Unisys A Series development centers. 



Table 12-122. Major Type 11-Minor Type 61 


Minor Type 


= 61 BNA Version 1 Debug (LOGBNADEBUG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to text of message (bytes) 


5-end 


Variable-length data pointed to by the LINK in this entry. The symbol hex 
"FF" means end-of-line, while two of them together mean end-of-text. 



The log entries in Table 12-123, "Major Type 11-Minor Types 62 through 64," are 
written whenever an X.25 remote terminal is added, modified, or deleted using 
the BNA commands NW ADD TERM, NW MOD TERM, or NW DELETE TERM, 
respectively. The following entries are written only when the BNA command NW LOG 
attribute is STANDARD or MAXIMUM. 



Table 12-123. Major Type 1 1 -Minor Types 62 through 64 



Minor Type 
Minor Type 
Minor Type 


= 62 Add X.25 Terminal (LOGX25ADDTERM) 

= 63 Modify X.25 Terminal (LOGX25MODIFYTERM) 

= 64 Delete X.25 Terminal (LOGX25DELETETERM) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to the remote terminal name (bytes) 


5 


LINK to the station name (bytes) 


6 


LINK to the terminal attribute list. The elements of this list are single 
words, structured in the following way: 

[47:08] Attribute number 
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Table 12-123. Major Type 11-Minor Types 62 through 64 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 


62 Add X.25 Terminal (LOGX25ADDTERM) 

63 Modify X.25 Terminal (LOGX25MODIFYTERM) 

64 Delete X.25 Terminal (LOGX25DELETETERM) 


Words 


Description 




[39:40] For some attribute numbers, this field simply contains the 
attribute value. For all other attribute numbers, this field is a LINK to 
variable-length information. 


7-end 


Variable-length data pointed to by the LINKs in this entry. 



The log entries in Table 12-124, "Major Type 11-Minor Types 65 through 67," are 
written whenever an X.25 application is added, modified, or deleted using the BNA 
commands NW ADD APPL, NW MOD APPL, or NW DELETE APPL, respectively. 
The following entries are written only when the BNA command NW LOG attribute is 
STANDARD or MAXIMUM. 



Table 12-124. Major Type 11-Minor Types 65 through 67 



Minor Type = 
Minor Type = 
Minor Type = 


65 Add X.25 Application (LOGX25ADDAPPL) 

66 Modify X.25 Application (LOGX25MODIFYAPPL) 

67 Delete X.25 Application (LOGX25DELETEAPPL) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to the application code file name (bytes) 


5 


LINK to the application attribute list. The elements of this list are single 
words, structured in the following way.- 

[47.08] Attribute number 

[39:40] For some attribute numbers, this field simply contains the 
attribute value. For all other attribute numbers, this field is a LINK to 
variable-length information. 
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Table 12-124. Major Type 11-Minor Types 65 through 67 (cont.) 



Minor Type 
Minor Type 
Minor Type 


= 65 Add X.25 Application (LOGX25ADDAPPL) 

= 66 Modify X.25 Application (LOGX25MODIFYAPPL) 

= 67 Delete X.25 Application (LOGX25DELETEAPPL) 


Words 


Description 


6-end 


Variable-length data pointed to by the LINKs in this entry. 



The log entry in Table 12-125, "Major Type 11-Minor Type 68," is written whenever 
there is a phase transition in the X.25 MCS. The following entry is written only when 
the BNA command NW LOG attribute is STANDARD or MAXIMUM. 

Table 12-125. Major Type 1 1 -Minor Type 68 



Minor Type 


= 68 X.25 MCS Phase Change (LOGX25PHASECHANGE) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


The new phase of the X.25 MCS. The following are valid X.25 MCS phases: 




0 = Not running 




1 = Initializing 




2 = Operating 




3 = Slow shutdown 




4 = Fast shutdown 
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The log entry in Table 12-126, "Major Type 11-Minor Type 69," is written whenever 
an X.25 virtual call is successfully established. The following entry is written only 
when the BNA command NW LOG attribute is STANDARD or MAXIMUM. 



Table 12-126. Major Type 11-Minor Type 69 



Minor Type = 


69 X.25 Call Established (L0GX25CALLESTAB) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to the name of the remote terminal for this call. 


5 


The X.25 station table index associated with this call. 


6 


LINK to the code file name of the local application that initiated this call. 


7 


The local endpoint token associated with this call. 


8 


The transmit packet size for this call. 


9 


The transmit window size for this call. 


10 


The transmit throughput for this call. 


11 


The receive packet size for this call. 


12 


The receive window size for this call. 


13 


The receive throughput for this call. 


14-end 


Variable-length data pointed to by the links in this entry. 



The log entry in Table 12-127, "Major Type 11-Minor Type 70," is written whenever 
an X.25 virtual call terminates. The following entry is written only when the BNA 
command NW LOG attribute is STANDARD or MAXIMUM. 



Table 12-127. Major Type 1 1 -Minor Type 70 


Minor Type = 


70 X.25 Call Terminated (LOGX25CALLTERM) 




Words 


Description 




0-3 

4 

5 


As described in Table 12-2, "First Four Log Entry Words" 
LINK to the name of the remote terminal for this call. 
The X.25 station table index associated with this call. 
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Table 12-127. Major Type 11 -Minor Type 70 (cont.) 



Minor Type 


= 70 X.25 Call Terminated (LOGX25CALLTERM) 


Words 


Description 


6 


LINK to the code file name of the local application that initiated this call. 


7 


The local endpoint token associated with this call. 


8 


The number of packets sent during this call. 


9 


The number of packets received during this call. 


10 


The number of octets sent during this call. 


11 


The number of octets received during this call. 


12 


The encoded reason for the termination of this call. 


13-end 


Variable-length data pointed to by the links in this entry. 



The log entry in Table 12-128, "Major Type 11-Minor Type 71," is written whenever 
an X.25 virtual call terminates, and there are call statistics in the X.25 clear 
indication/confirmation packet. The following entry is written only when the BNA 
command NW LOG attribute is STANDARD or MAXIMUM. 



Table 12-128. Major Type 11-Minor Type 71 



Minor Type 


= 71 X.25 Call Statistics (LOGX25CALLSTATS) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to the name of the remote terminal for this call. 


5 


The X.25 station table index associated with this call. 


6 


LINK to the code file name of the local application that initiated this call. 


7 


The local endpoint token associated with this call. 


8 


LINK to monetary unit information. 


9 


LINK to packet count information. 
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Table 12-128. Major Type 11-Minor Type 71 (cont.) 


Minor Type = 


71 X.25 Call Statistics (LOGX25CALLSTATS) 


Words 


Description 


10 

11-end 


LINK to call duration information. 

Variable-length information pointed to by the links in this entry. 



The log entry in Table 12-129, "Major Type 11-Minor Type 72," is written whenever 
an X.25 local endpoint is moved due to the execution of the MOVECOMNO function. 
The purpose of this function is to hand off the local endpoint of a virtual call to another 
application program. The following entry is written only when the BNA command NW 
LOG attribute is STANDARD or MAXIMUM. 



Table 12-129. Major Type 1 1-Minor Type 72 



Minor Type = 


72 X.25 Endpoint Moved (LOGX25ENDPTMOVED) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Old endpoint token. 


5 


New endpoint token. 


6 


LINK to the code file name of the old application. 


7 


LINK to the code file name of the new application. 


11-end 


Variable-length information pointed to by the links in this entry. 
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The log entry in Table 12-130, "Major Type 11-Minor Type 73," is written whenever 
the X.25 MCS outputs an operator message. The log entry simply consists of the 
operator message text. The following entry is written only when the BNA command 
NW LOG attribute is MINIMUM, STANDARD, or MAXIMUM. 



Table 12-130. Major Type 1 1-Minor Type 73 


Minor Type = 


73 X.25 REPORT (L0GX25REP0RT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to the operator message text. 


5-end 


Variable-length data pointed to by the LINK in this entry. 
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Pages 12-269 through 12-276 are deleted by -1 10. 
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Table 12-135. Major Type 12-Minor Type 5 



Minor Type = 


5 Unit Ready Entry (LOGVSI D UNIT READY) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


DLPID 


5 


VSID unit number 


Table 12-136. Major Type 12-Minor Type 6 


Minor Type = 


6 Unit Not Ready Entry (LOG_VSI D_UNIT_NOT_READY) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


DLP ID 


5 


VSID unit number 


6 


Problem code: a device-dependent integer that identifies the problem. (See 
the documentation for the device for an explanation of the values.) 


7 


LINK to the text that explains the problem 


8-end 


Variable-length data pointed to by LINK in this entry 


Table 12-137. Major Type 12-Minor Type 7 


Minor Type = 


7 Unit In Use Entry (LOG_BEGIN_VSID_USE) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


DLPID 


5 


VSID unit number 


6 


Identification of the page-writer job 
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Table 12-137. Major Type 12-Minor Type 7 (cont.) 



Minor Type = 


7 Unit In Use Entry (LOG_BEGIN_VSID_USE) 




Words 


Description 






[31:16] Page-writer job number 
[15:16] Page-writer task number 




7 
8 
9 
10 

11-end 


LINK to page-writer code file title (bytes) 
LINK to usercode for page-writer job (bytes) 
LINK to accesscode for page-writer job (bytes) 
LINK to chargecode for page-writer job (bytes) 
Variable-length data pointed to by the LINKS in this entry. 




Table 12-138. Major Type 12-Minor Type 8 


Minor Type = 


8 Unit Not In Use Entry (LOG_END_VSI D_USE) 




Words 


Description 




0-3 

4 

5 


As described in Table 12-2, "First Four Log Entry Words" 
DLP ID 

VSID unit number 




6 


Identification of the page-writer job 
[31:16] Page-writer job number 
[15:16] Page-writer task number 




7 
8 
9 
10 


LINK to page-writer code file title (bytes) 
LINK to usercode for page-writer job (bytes) 
LINK to accesscode for page-writer job (bytes) 
LINK to chargecode for page-writer job (bytes) 
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Table 12-138. Major Type 12-Minor Type 8 (cont.) 


Minor Type = 


8 Unit Not In Use Entry (LOG_END_VSID_USE) 


Words 


Description 


11 


The value of the HISTORY task attribute of the user library stack upon 
termination. (This is the private library stack that exports the entry points 
used by the page writer job.) 


12-end 


Variable-length data pointed to by the LINKS in this entry 



Table 12-139. Major Type 12-Minor Type 9 



Minor Type = 


9 Begin Printing a Copy Entry (LOG BEGI N VSI D PRI NTI NG) 




Words 


Descrintion 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 




4 


DLPID 




5 


VSID unit number 




6 


Identification of the page-writer job 






[31:16] Page-writer job number 






[15:16] Page-writer task number 




7 


LINK to page-writer code file title (bytes) 




8 


LINK to usercode for page-writer job (bytes) 




9 


LINK to accesscode for page-writer job (bytes) 




10 


LINK to chargecode for page-writer job (bytes) 




11 


Identification of the page-creator job 






[31:16] Page-creator job number 






[15:16] Page-creator task number 




12 


LINK to page-creator code file title (bytes) 




continued 
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Table 12-139. Major Type 12-Minor Type 9 (cont.) 



Minor Type = 


9 Begin Printing a Copy Entry (LOG_BEGIN_VSID_PRINTING) 


Words 


Description 


13 


LINK to usercode for page-creator job (bytes) 


14 


LINK to accesscode for page-creator job (bytes) 


15 


LINK to chargecode for page-creator job (bytes) 


16 


LINK to VSIDfile title (bytes) 


17 


LINK to file title of backup file, if it exists; otherwise zero (bytes) 


18 


Copy count information 




[47:24] Copy number of this copy (starting at 1) 




[23:24] Number of copies to be printed 


19-end 


Variable-length data pointed to by the LINKS in this entry 


Table 12-140. Major Type 12-Minor Type 10 


Minor Type = 


10 End of Printing a Copy Entry (LOG_END_VSI D_PRI NTI NG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


DLP ID 


5 


VSID unit number 


6 


Identification of the page-writer job 




[31:16] Page-writer job number 




[15:16] Page-writer task number 


7 


LINK to page-writer code file title (bytes) 


8 


LINK to usercode for page-writer job (bytes) 
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Table 12-140. Major Type 12-Minor Type 10 (cont.) 



Minor Type = 


10 End of Printing a Copy Entry (LOG_END_VSID_PRINTING) 


Words 


Description 


9 


LINK to accesscode for page-writer job (bytes) 


10 


LINK to chargecode for page-writer job (bytes) 


11 


Identification of the page-creator job 




[31:16] Page-creator job number 




[15:16] Page-creator task number 


12 


LINK to page-creator code file title (bytes) 


13 


LINK to usercode for page-creator job (bytes) 


14 


LINK to accesscode for page-creator job (bytes) 


15 


LINK to chargecode for page-creator job (bytes) 


16 


LINK to VSID file title (bytes) 


17 


LINK to file title of backup file, if it exists; otherwise zero (bytes) 


18 


Copy count information 




[47:24] Copy number of this copy (starting at 1) 




[23:24] Number of copies to be printed 


19 


Page count information 




[47:24] Number of "logical pages" printed 




[23:24] Number of physical pages (sheets of paper) printed 


20-end 


Variable-length data pointed to by the LINKS in this entry 



8600 0478-100 



12-275 



SUMLOG 



Table 12-141. Major Type 12-Minor Type 11 



Minor Type = 


11 Special Log Information Entry (LOG_VSID_EVENT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


DLP ID 


5 


VSID unit number 


6 


Event code: a device-dependent integer that identifies the event to be 
logged (see the documentation for the device for an explanation of the 
values) 


7 


LINK to the text that defines, describes, or clarifies the event (bytes) 


8-end 


Variable-length data pointed to by the LINK in this entry 


Table 12-142. Major Type 12-Minor Type 12 


Minor Type = 


12 Peripheral Interface Error Entry (LOG_VSID_ERROR_LOG) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


DLP ID 


5 


VSID unit number 


6 


LINK to the VSID error log (bytes) 


7-end 


The VSID error log pointed to by the LINK in this entry. The format and 
content of the VSID error log can be found in the maintenance 
documentation (PTD/DOC/MAINT/NIP) included with the PTD package for 
the DLP. The error log begins with Word 3 of the Retry Log described in 
that document. 
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Major Type = 13 BNA Version 2 Entry (LOGMAJBNAE) 

The BNA Version 2 Network Encoded Messages Programming Reference Manual, 
Volume 2 explains the format of the log records after Word 3. 



Table 12-143. Major Type 13-Minor Types 0 and 1 


Minor Type = 
Minor Type = 


0 General BNA Version 2 Log Entry 

1 Local Task Support Activity Log Entry 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4-end 


Variable-length data 



8600 0478-110 



12-277 



SUMLOG 



Major Type = 14 MLS Message Entry (LOGMAJMLS) 

Major Type 14 logs MCP messages. The raw log contains the message number and the 
parameters used to construct the message that was displayed. 

If you are writing a log analysis program, the message text can be displayed by having 
the program call the MCPMESSAGESEARCHER procedure. You can indicate which 
message is to be translated by passing the message number (Word 6) as a parameter, 
and having the pointer to the message parameter list directed to Word 7. 

Table 12-144. Major Type 14-Minor Types 1, 4, 9 and 10 



Minor Type = 1 RSVP Message Entry (LOGMLSRSVP) 

Minor Type = 4 INFO Message Entry (LOGMLSINFO) 

Minor Type = 9 Unit RSVP Message Entry (LOGMLSUNITRSVP) 

Minor Type = 10 Special RSVP Message Entry (LOGMLSSPECIALRSVP) 



Words Description 

0-3 As described in Table 12-2, "First Four Log Entry Words" 

4 Length of message parameter list in words, plus 2 

5 0 (zero) or mix number 

6 Message number 

7-end, minus Message parameter list 
three 



The message parameter list consists of zero or more contiguous output 
message parameters. Output message parameters are described in the 
ALGOL Programming Reference Manual, Volume 1: Basic 
Implementation . 

Each output message parameter is formatted as follows: 

• Byte 1 = parameter number (1 through 255, or 0. Zero marks the 
end of the message parameter.) 

• Byte 2 and 3 = length (in bytes) of the text that follows. The length 
can be from 0 to 65535 bytes. 

• Byte 4 through end = text of message parameter 

Last three The identity (if any) of the object code file that displayed the message, 

words 
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Major Type = 15 Volume Status Entry (LOGMAJVOL) 

The log entries in Table 12-145, "Major Type 15-Minor Types 1 through 5," describe 
the state of disk and tape volumes on the system. When a disk or tape volume comes 
online or is taken offline, a volume online or offline entry is issued. The following 
events can cause volume online entries to be issued: halt/load, ACQUIRE, or RC. The 
following events can cause volume offline entries to be issued for disk: CLOSE, PO, 
FREE, RC, LB, PG; and for tape: LOCK, R\ty FREE, taking tape offline. 

Note that the SV (Save) or UR (Unit Reserved) system commands do not generate 
volume offline entries. These commands are used to suspend file open actions, but they 
do not cause the system to close out the internal information concerning the volume. 
Also, a subsequent RY (Ready) or UR- system command in such a case does not cause a 
reestablishment of the volume internally, so that no volume online entry is issued. 

When a tape volume is purged or is assigned a new serial number, a tape volume purged 
entry is issued. When a tape volume comes online with a write ring, it appears as a 
scratch tape if the first file on the tape has expired. In this case, a tape volume expired 
entry is issued. When a scratch tape is opened for output or is copied to, a tape volume 
new file entry is issued. 



Table 12-145. Major Type 15-Minor Types 1 through 5 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 Volume Online (LOGVOLON) 

2 Volume Offline (LOGVOLOFF) 

3 Tape Volume Purged (LOGVOLPG) 

4 Tape Volume Expired (LOGVOLEXP) 

5 Tape Volume NEWFILE (LOGVOLNEW) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


External device number 


5 


Peripheral Description 

[47: 8] Peripheral Type (See Table 12-22, "Peripheral Logical Types.") 
[39: 8] Peripheral subtype (See Table 12-23, "Peripheral Subtypes.") 
[31: 9] Density (See Table 12-24, "Peripheral Densities.") 


6 


Serial Number in EBCDIC 


7 


Volume Status 

[47: 1] SET if volume is scratch 
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Table 12-145. Major Type 15-Minor Types 1 through 5 (cont.) 



Minor Type = 1 Volume Online (LOGVOLON) 
Minor Type = 2 Volume Offline (LOGVOLOFF) 
Minor Type = 3 Tape Volume Purged (LOGVOLPG) 
Minor Type = 4 Tape Volume Expired (LOGVOLEXP) 
Minor Type = 5 Tape Volume NEWFILE (LOGVOLNEW) 

Words Description 

[46: 1] SET if error was detected in label (parts of log entry might be 
missing or invalid) 

[45: 1] SET if volume is listed in the volume library as VOLUMEd 
[44: 1] Has a write ring 

[43: 1] SET if volume is listed in the volume directory 

The remainder of this log entry is not filled in if the volume is scratch (except for Words 17 and 
18, which store the new serial number and new density for tape volume purged entries). 

8-10 Volume or family name (first byte is binary number of characters that 

follow). 

The remaining words of the log entry differ depending on whether the volume is a disk or tape 
volume. 

For disk 
volumes: 

1 1 Status fields: 

[47: 1] SET if disk has directory (for example, base pack) 

[46: 1] SET if disk is interchange mode 

[45: 1] SET if disk is IAD 

[44: 1] SET if disk is mirrored 
The remainder of the disk log entry is not filled in for interchange mode packs. 



12 Family index number 

13 Family serial number in EBCDIC (serial number of original base pack for 
family) 

14 Family creation date (Julian = YYDDD) 

1 5 Family creation time (where time is the number of 2.4 microsecond clock 
ticks since midnight) 

16 System serial number of site where family was originally created 

continued 
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Table 12-145. Major Type 15-Minor Types 1 through 5 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 Volume Online (LOGVOLON) 

2 Volume Offline (LOGVOLOFF) 

3 Tape Volume Purged (LOGVOLPG) 

4 Tape Volume Expired (LOGVOLEXP) 

5 Tape Volume NEWFILE (LOGVOLNEW) 


Words 


Description 


For tape 
volumes: 




11 


[23: 1] LOCKEDFILE attribute 
L<£U: lj rarity 

[16: 1] SET if LABELTYPE field is valid 
[15: 4] LABELTYPE attribute 


12 


[47: 9] Label level 
Lo/:i4j uycie 
[23: 8] Version 

[14:15] FILESECTION number 


13 


[45:14] System serial number of system that created file 

[31: 4] GENERATION attribute 

[27:11] SAVEFACTOR attribute 

[16:17] CREATIONDATE (Julian = YYDDD) 


14-16 


Tape usercode or zeros (first byte is binary count of characters in the 
usercode) 


17 


New serial number of tape volume (this can differ from original serial 
number above for SN MT entry) 


18 


New density 

[31 : 9] New density of tape volume. This can differ from original density 
above for SN MT entry. (See Table 12-24, "Peripheral Densities.") 


19-21 


File name identifier (for the first file on the tape volume). The first byte of 
the name is a binary number that counts characters in the name that 
follows. 
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( 

Table 12-145. Major Type 15-Minor Types 1 through 5 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 Volume Online (LOGVOLON) 

2 Volume Offline (LOGVOLOFF) 

3 Tape Volume Purged (LOGVOLPG) 

4 Tape Volume Expired (LOGVOLEXP) 

5 Tape Volume NEWFILE (LOGVOLNEW) 


Words 


Description 


22-end 


Variable-length data pointed to by the LINKs in this entry 



The volume directory entries in Table 12-146, "Major Type 15-Minor Types 6 through 
11," are issued when the TAPECHECK option of the SECOPT system command has 
been set to AUTOMATIC. This function is only available on an InfoGuard system. 
Volume directory add, change, delete, and destroy entries are issued when the 
corresponding VOLUME statements in WFL (or the equivalent SETSTATUS requests) 
are executed. Volume directory overwrite entries are issued when a volume directory 
entry is updated because a volume label has been overwritten. Volume directory purge 
entries are issued when a volume directory entry is updated because a volume label has 
been purged. 

Because part of the contents of this log entry is a volume directory data entry, the 
LINKs used in this entry differ from the general format, and an offset of 3 has to be 
added to any index value to get the actual index value in the log entry. The LINK 
format is as follows: 

Field Meaning 

[23: 12] Length of the item in words 

[11:12] Index to the start of the item, minus 3 

The format of all these log entries is shown in Table 12-146. 
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Table 12-146. Major Type 15-Minor Types 6 through 11 



Minor Type = 


6 Volume Directory Add (LOGVSADD) 


Minor Type = 


7 


Volume Directory Change (LOGVSCHANGE) 


Minor Type = 


8 


Volume Directory Delete (LOGVSDELETE) 


Minor Type = 


9 


Volume Directory Destroy (LOGVSDESTROY) 


Minor Type = 


10 Volume Directory Overwrite (LOGVSOVER) 


Minor Type = 


1 1 Volume Directory Purge (LOGVSPURGE) 


Words 




Description 


0-3 




As described in Table 12-2, "First Four Log Entry Words" 


4 




Type of record 






[47: 8] EBCDIC "D" (data block) 






[39: 8] Volume family LABELKIND 






[31: 8] Internal MCP structure level 






[15: 4] Volume family medium type 






1 = Scratch tape 






2 = Other tape 






3 = Disk or pack volume 






[10: 1] SET if matching by serial number only 






[9:10] Index to start of variable-length items (offset -3 words) 


5 




Date and time of last volume directory update 


6 




Volume family creation date (Julian = YYDDD) 


7 




Creation site system serial number 


8 




SAVEFACTOR attribute value of first file on volume 


9-11 




Volume family owner usercode (substandardform) 


12-14 




Volume family FAMILYNAME (substandardform) 


15 




Security attributes 






[47: 2] Security type 






0 = Public 






1 = Guarded 






2 = Controlled 
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Table 12-146. Major Type 15-Minor Types 6 through 11 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


6 Volume Directory Add (LOGVSADD) 

7 Volume Directory Change (LOGVSCHANGE) 

8 Volume Directory Delete (LOGVSDELETE) 

9 Volume Directory Destroy (LOGVSDESTROY) 

10 Volume Directory Overwrite (LOGVSOVER) 

11 Volume Directory Purge (LOGVSPURGE) 


Words 




Description 






3 = Private 






[45: 2] Security use 






0 = 10 






1 = In 






2 = Out 






3 = Secured 


16-18 




Reserved for future use 


1 Q 




Link to the serial numbers of each volume in the family. Each serial number 
is stored in one word in EBCDIC. 


20 




Link to volume status word per family member. Volume status word format 
is 

[47: 1] SET if the volume is permanently owned 
[46: 1] SET if the volume is not RESTRICTED 
[45: 1] SET if the volume is destroyed 
[ 5: 6] Volume KIND attribute value 


21 




Link to the volume family GUARDFILE title 


22-end 




Variable-length data pointed to by the links in this entry 
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Major Type = 16 File Status Entry (LOG MAJ FILE) 

The file status entries in Table 12-147, "Major Type 16-Minor Types 1 through 
6," describe the creation, removal, title change, and security attribute changes of 
permanent disk files, and the copying of disk and tape files. Note that once a disk 
file is entered into the directory, the file status (FILEKIND, CYCLE, VERSION and 
timestamp) can be changed by programs. These changes are not subsequently logged. 

When a new file is entered into the directory or an old file name in the directory is 
changed, a duplicate file name condition can occur. In order to update the directory, the 
system removes the duplicate file. The log entry for a file creation or file name change 
also describes the duplicate file removal in these cases. 

When a log entry of Major Type 16, Minor Type 1 (File Creation & Copy) is logged, and 
the file involved is a guard file, the system creates a backup copy of the guard file. Refer 
to "Requesting Copies of Configuration Files" earlier in this section. 



Table 12-147. Major Type 16-Minor Types 1 through 6 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 File Creation & Copy (LGFLCOPYNEWV) 

2 File Creation (LGFLNEWV) 

3 File Removal (LGFLREMOVEV) 

4 File Title Change (LGFLCHANGEV) 

5 File Security Attribute Change (LGFLSECATTV) 

6 File Copy (LGFLCOPYV) 


Words 




Description 


0-3 




As described in Table 12-2, "First Four Log Entry Words" 


4 




Miscellaneous 

[47: 4] Error indicator (0 = no error) 

[31: 8] Peripheral type (See Table 12-22, "Peripheral Logical Types.") 


5 




External device number of the disk drive containing the base pack for the 
disk family 


6 




The serial number (in EBCDIC) of the original base pack for the disk family; 
can also be the serial number of the tape for file copy entries 


7-9 




The disk family name, first byte contains the length; can also be the tape 
name for file copy entries 


10 




LINK to old file name, zero for file create entries 


11 




LINK to new file name, zero for file removal entries or file copy entries 
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Table 12-147. Major Type 16-Minor Types 1 through 6 (cont.) 



Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 


= 1 File Creation & Copy (LGFLCOPYNEWV) 

= 2 File Creation (LGFLNEWV) 

= 3 File Removal (LGFLREMOVEV) 

= 4 File Title Change (LGFLCHANGEV) 

= 5 File Security Attribute Change (LGFLSECATTV) 

= 6 File Copy (LGFLCOPYV) 


Words 


Description 


12 


File status of old file, zero for file create entries 
[47: 1] Set if file is cataloged 
[45:14] File CYCLE attribute 
[31: 8] File VERSION attribute 
[11:12] File FILEKIND attribute 


13 


File status of new file, zero for file removal entries or file copy entries 

odlllc lUlllldl do VVUIU Lc. 


14 


File status of removed duplicate file, nonzero if creation or title change 
caused duplicate file to be removed, zero for file copy entries 

Same format as Word 12 


15 


Timestamp of old file, zero for file create entries 


16 


Timestamp of new file, zero for file removal entries or file copy entries 


17 


Timestamp of removed duplicate file, nonzero if creation or title change 
caused duplicate file to be removed, zero for file copy entries 


18 


SECURITYTYPE attribute value of new file, zero for file copy entries 


19 


SECURITYUSE attribute value of new file, zero for file copy entries 


20 


LINK to SECURITYGUARD attribute value of new file, zero for file copy 
entries 


21 


Variable-length data pointed to by the LINKs in this entry 
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Major Type =17 DATA COMM Configuration Entry 
(LOGMAJJDCCONFIGV) 



Table 12-148. Major Type 17-Minor Type 1 



Minor Type = 


1 Data comm change entry (LOGMI N DCCHANGEV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Action code 




1 = Create 




2 = Modify 




3 = Move 




4 = Add 




5 = Subtract 




6 = Copy 


5 


Structure code 




1 = Line 




2 = Station 




3 = MCS 




4 = Algorithm 




5 = Editor 


6 


LINK to structure name 


7 


LINK to miscellaneous information 


8-end 


Variable-length data pointed to by LINKs in this entry 
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When a log entry of Major Type 17, Minor Type 2 (Data Comm Installation & Copy) 
is logged, the system creates a backup copy of the DATACOMINFO file. Refer to 
"Requesting Copies of Configuration Files" earlier in this section. 



Table 12-149. Major Type 17-Minor Types 2 and 3 



Minor Type 
Minor Type 


= 2 Data comm Installation & Copy Entry (LOGMIN DCINSTCOPYV) 
= 3 Data comm Installation Entry (LOGMIN_DCINSTV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to new data comm configuration file name 


5 


LINK to copied file title 


6-end 


Variable-length data pointed to by LINKs in this entry 



12-288 



8600 0478-100 



SUMLOG 



Major Type =18 COMS Configuration Entry 
(LOGMAJ_COMSCONFIGV) 



Table 12-150. Major Type 18-Minor Types 1 through 11 



Minor Type 


= 


1 Agenda Change (LOGMIN AGENDAV) 


Minor Type 


= 


2 Program Change (LOGMI NPROGRAMV) 


Minor Type 




3 Processing-Item Change (LOGMIN PROCITEMV) 


Minor Type 


= 


4 Processing-Item List Change (LOGMI N_PROCITEMLV) 


Minor Type 




5 Library Change (LOGMIN COMSLIBV) 


Minor Type 


_ 


6 Database Change (LOGMIN COMSDBSV) 


Minor Type 




7 Station Change (LOGMIN STATIONV) 


Minor Type 


_ 


8 Station List Change (LOGMIN STATIONLV) 


Minor Type 




9 Window Change (LOGMIN wTNDOWV) 


Minor Type 


: 


10 Window List Change (LOGMIN WINDOWLV) 


Minor Type 


= 


11 Usercode Change (LOGMI N_COMSUSERV) 


Words 




Description 


0-3 




As described in Table 12-2, "First Four Log Entry Words" 


4 




Update information 






[15: 8] Type 












9 — Mnriifv 

Cm — iviuuiiy 






3 = Delete 






[7:8] Number of items affected 


5-end 




Byte-oriented stream of item descriptions in the following format per item: 






Byte Meaning 






0-1 Item length in bytes 






2 Item field number 






Minor Type = 1 Agenda 






1 = Agenda name 






2 = Window name 






3 = Default input agenda 






4 = Default output agenda 






5 = Processing-item list 



continued 
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Table 12-150. Major Type 18-Minor Types 1 through 11 (cont.) 



Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
iviinor type 
Minor Type 
Minor Type 


— 
= 

= 

= 
= 

= 
= 


1 M | n | £ ■ S\ ■■111 a j%r*k||\A|f\ 

1 Agenda Change (LOGMIN AGENDAV) 

2 Program Change (LOGMIN PROGRAMV) 

3 Processing-Item Change (LOGMIN_PROCITEMV) 

4 Processing-Item List Change (LOGMIN PROCITEMLV) 

5 Library Change (LOGMIN_COMSLIBV) 

6 Database Change (LOGMIN COMSDBSV) 

7 Station Change (LOGMIN STATIONV) 

8 Station List Change (LOGMI NSTATIONLV) 
jj winuow vrfiangc injoiviirM winuuwv; 

10 Window List Change (LOGMIN WINDOWLV) 

11 Usercode Change (LOGMI N_COMSUSERV) 


Words 




Description 






6 = Destination program 






Minor Type = 2 Program 






1 = Program name 






2 = Code file title 






3 = Usercode 






4 - Family 






5 = Database name 






Minor Type = 3 Processing- Item 






1 = Processing-item name 






2 = Actual name of library object 






3 = Library name 






Minor Type = 4 Processing- Item List 






1 = List name 






2 = Processing-item name 






Minor Type = 5 Library 






1 = Library name 






2 = Code file title 






Minor Type = 6 Database 






1 = Database name 






2 = Usercode name 






3 = Code file title 



continued 
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Table 12-150. Major Type 18-Minor Types 1 through 11 (cont.) 



Minor 


Tvoe 




1 Agenda Change (LOGMIN AGENDAV) 


Minor 


Type 


= 


2 Program Change (LOGMI N_PROGRAMV) 


Minor 


Type 




3 Processing-Item Change (LOGMIN PROCITEMV) 


Minor 


Type 


— 


4 Processing-Item List Change (LOGMIN PROCITEMLV) 


Minor 


Type 


- 


5 Library Change (LOGMI NCOMSLIBV) 


Minor 


Type 




6 Datahasp Chance fl OGMIN COMSDRSV) 


Minor 


Type 


= 


7 Station Change (LOGMIN STATIONV) 


Minor 


Type 


= 


8 Station List Change (LOGMI N_STATIONLV) 


Minor 


Type 




9 Window Chance f LOGMIN WINDOWV) 


Minor 


Type 


= 


10 Window List Change (LOGMIN WINDOWLV) 


Minor 


Type 


— 


11 Usercode Change (LOGMI N_COMSUSERV) 


Words 




Description 








Minor Type = 7 Station 








1 = Station name 








2 = Hostname 








3 = Default window name 








4 = Default usercode name 








5 = Control station 








6 = Super user 








7 = System user 








8 = Privileged user 








9 = Continuous log on 








Minor Type = 8 Station List 








1 = Station list name 








2 = Station name 








Minor Type = 9 Window 








1 = Window name 








2 = Virtual station name 








3 = Remote file window 








4 = Remote file program name 








5 = MCS window 








6 = MCS code file title 








7 = Notify open activity 



continued 
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Table 12-150. Major Type 18-Minor Types 1 through 11 (cont.) 


Minnr Tuna 

iviinoi iypc 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 
Minor Type 


= 
= 

= 

_ 
= 

= 
= 


1 HgCflQa \>fl<lllgc \LVsVIIVII PI Huu IXUHv / 

2 Program Change (LOGMIN PROGRAMV) 

3 Processing-Item Change (LOGMIN PROCITEMV) 

4 Processing-Item List Change (LOGMIN PROCITEMLV) 

5 Library Change (LOGMI NCOMSLI BV) 

6 Database Change (LOGMIN COMSDBSV) 

7 Station Change (LOGMIN STATIONV) 

8 Station List Change (LOGMI N.STATIONLV) 

Q U/indnui fhanno l\ Of^MIM \A/I MnfHAA/1 

3 winaow v>nange ^luuiviiin wiinuuwvj 

10 Window List Change (LOGMIN WINDOWLV) 

11 Usercode Change (LOGMI N_C0MSUSERV) 


Words 




Description 






8 = Notification text 






9 = Notify on activity 






10 = Notification text 






Minor Type = 10 Window List 






1 = Window list name 






2 = Window name 






Minor Type = 11 Usercode 






1 = Usercode name 






2 = Default window name 






3 = Valid window list name 






4 = Valid station list name 






5 = Control capability 






Byte 3 Item format 






1 = Boolean 






2 = Numeric 






3 = String 






Byte 4 List operation type (Only applicable for list 

items) 






1 = Add 






2 = Subtract 






Byte 5 Unused 


continued 
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Table 12-150. Major Type 18-Minor Types 1 through 11 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 Agenda Change (LUiaMiN aulnuav) 

2 Program Change (LOGMIN PROGRAMV) 

3 Processing-Item Change (LOGMIN PROCITEMV) 

4 Processing-Item List Change (LOGMIN PROCITEMLV) 

5 Library Change (LOGMIN COMSLIBV) 

6 Database Change (LOGMIN COMSDBSV) 

7 Station Change (LOGMIN STATIONV) 

8 Station List Change (LOGMIN STATIONLV) 

9 Window Change (LOGMIN WINDOWV) 

10 Window List Change (LOGMIN WINDOWLV) 

11 Usercode Change (LOGMIN_COMSUSERV) 


Words 


Description 


Byte 6-end Item value, variable length as specified in 

bytes 1-2 


Whenever a log entry of Major Type 18, Minor Type 12 (Load File Copy) is logged, the 
system creates a backup copy of the COMS load file. Refer to "Requesting Copies of 
Configuration Files" earlier in this section. 




Table 12-151. Major Type 18-Minor Types 12 and 13 


Minor Type = 
Minor Type = 


12 Load File Copy (LOGMIN COMSLOADCOPYV) 

13 Load File (LOGMIN_COMSLOADV) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to load file title 


5 


LINK to load file copy title 


6-end 


Variable-length data pointed to by LINKs in this entry 



i. 
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Major Type = 19 Diagnostics Entry (LOGMAJJDIAGNOSTICS) 

The log entries in Table 12-152, "Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, 
and 16" store diagnostics information for several types of data comm networks. In this 
table, the term Ethernet® refers to a type of local area network (LAN). 



Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 

Minnr Tvnp — 

■VII 1 IUI i y 

Minor Type = 
Minor Type = 
Minor Type = 


I Distributed Systems Service (LOGDIAG DSS) 

4 Message Handling System (LOGDIAGMHS) 

5 Open Systems Interconnection (LOGDIAG OSI) 

6 TCP/I P (LOGDI AGJTCPI P) 

7 Network-Independent Software (LOGDIAG NIS) 

II Host LAN Connection (LOGDIAG HLCN) 

12 OSI Directory (LOGDI AG_DIR) 

13 Network Management System (LOGDI AG NMS) 
16 Systems Network Architecture (LOGDIAG SNA) 


Words 


Description 




0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


[47:13] 


Length of entry in bytes or lines, depending on the data format. See the 
description for Word 5-end. 




[34:19] 


Reserved for future use 




[15: 4] 


Data format 

0 = Raw binary data 

1 = Formatted text 

2 through 15 = Reserved for future formats 




[11:12] 


Subtype indicator. Each subtype contains log entries from particular network 
diagnostic options. The meaning of the subtype indicator depends on the minor 
type the log entry is for. The following are the possible subtype indicator values 
for each minor type, and the network diagnostic options that are logged under 
each subtype: 

Minor Type 1 - Distributed Systems Service (DSS) 

Subtype JOBFORMATTER Define Meaning 

6 LOG Dl AG_DSS_FTAM File Transfer, Access, 

and Management 
(FTAM) 



continued 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 1 Distributed Systems Service (LOGDIAGDSS) 

Minor Type = 4 Message Handling System (LOGDIAG_MHS) 

Minor Type = 5 Open Systems Interconnection (LOGDIAG OSI) 

Minor Type = 6 TCP/I P (LOGDI AG_TCPI P) 

Minor Type = 7 Network- Independent Software (LOGDIAG NIS) 

Minor Type = 11 Host LAN Connection (LOGDIAG_HLCN) ~ 

Minor Type = 12 OSI Directory (LOGDI AG_DIR) 

Minor Type = 13 Network Management System (LOGDIAG NMS) 

Minor Type =16 Systems Network Architecture (LOGDI AG_SNA) 


Words Description 


7 


LOG Dl AG_DSS_FTP 


File Transfer Protocol 
(FTP) 


8 


LOGDIAG_DSS_SMTP 


Simple Mail Transfer 
Protocol (SMTP) 


i n 


LUvjUIAu Uoo nLUIN 1 tKM 


Host LAN Connection 
(HLCN) Terminal 

^pr\/i^P 

OCI V IOC 


11 


LOGDIAGDSSRES 


Resolver (RES) 


Minor Type 4 - 


- Message Handling System (MHS) 




Subtype 


JOBFORMATTER Define 


Meaning 


0 


LOGDIAG_MHS_OTHER 


Other MHS entries 


1 


LOG Dl AGM HSRTS 


MHS reliable transfer 
service 


2 


LOGDIAG_MHS_MTA 


MHS message 
transfer agent 


3 


LOG Dl AGM HSAS 


MHS addressing 
services 


4 


LOGDIAG_MHS_UI 


MHS user interface 


Minor Type 5 - 


- Open Systems Interconnection (OSI) 




Subtype 


JOBFORMATTER Define 


Meaning 


0 


LOGDIAG_OSI_OTHER 


Other OSI entries 


2 


LOGDIAG_OSI_PRESENTATION 


OSI presentation layer 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 1 Distributed Systems Service (LOGDIAGDSS) 

Minor Type = 4 Message Handling System (LOGDIAG MHS) 

Minor Type = 5 Open Systems Interconnection (LOGDIAG OSi) 

Minor Type = 6 TCP/IP (LOGDIAG_TCPIP) 

Minor Type = 7 Network-Independent Software (LOGDIAG NIS) 

Minor Type =11 Host LAN Connection (LOGDIAG_HLCN) 

Minor Type = 12 OSI Directory (LOGDIAG DI R) 

Minor Type =13 Network Management System (LOGDIAG NMS) 

Minor Type =16 Systems Network Architecture (LOGDIAG_SNA) 


Words Description 


3 


LOGDIAG_OSI_SESSION 


OSI session layer 


4 


LOGDIAGOSI TRANSPORT 


OSI transport layer 


5 


LOGDIAG_OSI_NSI 


OSI network services 
interface 


6 


LOGDIAGOSIACSE 


OSI application 
control service 
element 


7 


L0GDIAG_OSI_ENVIR0NMENT 


OSI environment 
manager 


19 


LOGDIAG_OSI_CM 


OSI connection 
manager 


20 


LOGDIAG_OSI_PIE 


OSI process 

intercommunication 

element 


28 


LOGDIAGOSIEAM 


OSI endpoint address 






manager 


Minor Type 6 - 


- TCP/IP (TCPIP) 




Subtype 


JOBFORMATTER Define 


Meaning 


0 


LOG Dl AG_TCPI P_OTH ER 


Miscellaneous 


1 


LOGDIAG_TCPIP_PORTDEBUG 


MCP - PORTDEBUG 


2 


LOGDIAG_TCPIP_IP 


Internet Protocol layer 


3 


LOGDIAG_TCPIP_ARP 


Address Resolution 
Protocol function 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 1 Distributed Systems Service (LOGDIAG DSS) 

Minor Type = 4 Message Handling System (LOGDIAG MHS) 

Minor Type = 5 Open Systems Interconnection (LOGDIAG OSI) 

Minor Type = 6 TCP/IP (LOGDIAG_TCPIP) 

Minor Type = 7 Network- Independent Software (LOGDIAG NIS) 

Minor Type = 11 Host LAN Connection (LOGDIAGHLCN) 

Minor Type = 12 OSI Directory (LOGDIAG_DIR) 

Minor Type =13 Network Management System (LOGDIAG NMS) 

Minor Type =16 Systems Network Architecture (LOGDIAG SNA) 


Words Description 


4 


LOGDIAG_TCPIP_RIP 


Route Information 
Protocol function 


5 


LOGDIAG_TCPIP_UDP 


User Datagram 
rioiocoi layer 


fi 
%j 


1 OGDIAG TPPIP IPMP 


Intornot Pnntml 

MIlCIIICl VvUIIUUl 

Message Protocol 
function of IP 


"7 
1 


LUlaUIAla lUrlr lUrlVloK 


TCP Manager function 


8 


LOGDIAG TCPIP PIM 

L.V-/ \J U/ 1 /V\J 1 w 1 1 1 1 IIVI 


Pnnnpptinn nnpn ?inrl 

\J\J\ II IClslMJI I upcii clIIU 

close reports 


9 




Reserved 


10 


LOGDIAG_TCPIP_SNMP 


Entries generated 
during the process of 
an SNMP command 


11 


LOGDIAG_TCPIP_TCP 


Transmission Control 
Protocol layer 


Minor Type 7- 


- Network-Independent Software (NIS) 




Subtype 


JOBFORMATTER Define 


Meaning 


0 


LOG Dl AGN 1 S_OTH ER 


Other NIS entries 


11 


LOGDIAG_NIS_MSG 


NIS message module 


12 


LOGDIAG_NIS_INPUT 


NIS input module 


13 


LOGDIAG_NIS_OUTPUT 


NIS output module 


14 


LOGDIAG_NIS_ERROR 


NIS error module 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 1 Distributed Systems Service (LOGDIAGDSS) 

Minor Type = 4 Message Handling System (LOGDIAG_MHS) 

Minor Type = 5 Open Systems Interconnection (LOGDIAG OSI) 

Minor Type = 6 TCP/IP (LOGDIAG_TCPIP) 

Minor Type = 7 Network- Independent Software (LOGDIAG NIS) 

Minor Type =11 Host LAN Connection (LOGDIAG_HLCN) 

Minor Type = 12 OSI Directory (LOGDIAG DIR) 

Minor Type =13 Network Management System (LOGDIAG NMS) 

Minor Type =16 Systems Network Architecture (LOGDIAG SNA) 


Words Description 


15 


LOGDIAG, 


_NIS_DEBUG 


NIS debug module 


16 


LOGDIAG, 


_NIS_LOCK 


NIS lock module 


i 7 


LOGDIAG_ 


_NIS_QUEUE 


MIO LjUcUt. IIIUUUIC 


18 


LOGDIAG_ 


_NIS_KIO 


NIS KEYEDIO module 


19 


LOGDIAG_ 


_NIS_NS 


NIS network servant 
module 


21 


LOGDIAG, 


,NIS_ROUTER 


NIS router module 


26 


LOGDIAG_ 


_NIS_TOKEN 


NIS token module 


27 


LOGDIAG, 


_NIS_PARSE 


NIS parse module 


28 


LOGDIAG, 


_NIS_REG 


NIS registration 
facility 


Minor Type 11 


- Host LAN Connection (HLCN) 




Subtype 


JOBFORMATTER Define 


Meaning 


0 


LOGDIAG, 


_HLCN_PIM 


PIM module 


1 


LOGDIAG, 


HLCN_PIE 


PIE module 


2 


LOGDIAG, 


HLCN_NM 


Network manager 
module 


3 


LOGDIAG, 


HLCNJDI 


Operator interface 
module 


4 


LOGDIAG, 


HLCN_DM 


Dialog manager 
module 


5 


LOGDIAG, 


HLCNNWMGR 


NWMGR module 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 1 Distributed Systems Service (LOGDIAGDSS) 

Minor Type = 4 Message Handling System (LOGDIAGMHS) 

Minor Type = 5 Open Systems Interconnection (LOGDIAG OSI) 

Minor Type = 6 TCP/IP (LOGDIAGJTCPIP) 

Minor Type = 7 Network- Independent Software (LOGDIAG NIS) 

Minor Type =11 Host LAN Connection (LOGDIAG_HLCN)~ 

Minor Type = 12 OSI Directory (LOGDIAG DIR) 

Minor Type = 13 Network Management System (LOGDIAG NMS) 

Minor Type =16 Systems Network Architecture (LOGDIAGSNA) 


Words Description 


6 


LOGDIAG, 


HLCN. 


STREAMS 


STREAMS module 


7 


LOGDIAG. 


HLCN 


SLOOP 


SLOOP module 


8 


LOGDIAG. 


.HLCN. 


.BOUNCE 


BOUNCE module 


9 


LOGDIAG. 


.HLCN. 


IPX 


IPX module 


10 


LOGDIAG 


HLCN 


NETBIOS 


NetBIOS module 


11 


LOGDIAG. 


.HLCN. 


.NBIX 


NBIX module 


12 


LOGDIAG. 


HLCN. 


ETH 


Ethernet driver 


13 


LOGDIAG 


HLCN 


SPX 


SPX module 


14 


LOGDIAG. 


.HLCN. 


NBDG 


NetBIOS datagram 
module 


15 


LOGDIAG 


_HLCN_ 


JNTSWP 


Integer swap module 


16 


LOGDIAG 


HLCN_ 


MACSWP 


Medium access 
control swap module 


17 


LOGDIAG. 


HLCN 


SWPTEST 


Swap test module 


Minor Type 12 


- OSI Directory (DIR) 




Subtype 


JOBFORMATTER Define 


Meaning 


0 


LOGDIAG_DIR_DUA 


Directory user agent 


1 


LOGDIAG. 


DIR_DSA 


Directory system 
agent 


2 


LOGDIAG. 


DIR_DUACTL 


DUA control modules 


3 


LOGDIAG_DIR_DUACMN 


DUA common 
modules 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 1 Distributed Systems Service (LOGDIAG DSS) 

Minor Type = 4 Message Handling System (LOGDIAGMHS) 

Minor Type = 5 Open Systems Interconnection (LOGDIAG OSI) 

Minor Type = 6 TCP/I P (LOGDI AG_TCPI P) 

Minor Type = 7 Network-Independent Software (LOGDIAG NIS) 

Minor Type = 11 Host LAN Connection (LOGDIAG HLCN) 

Minor Type = 12 OSI Directory (LOGDIAG_DIR) 

Minor Type = 13 Network Management System (LOGDIAGNMS) 

Minor Type = 16 Systems Network Architecture (LOGDIAG SNA) 


Words Description 


4 LOGDIAG_DIR_DUARMT 


DUA remote modules 


5 LOGDIAG_DIR_DSAPRS 


DSA parsing modules 


6 LOGDIAG_DIR_DSACNT 


DSA control modules 


7 LOGDIAG_DIR_DSADIB 


DSA database 
modules 


8 LOGDIAG_DIR_CSERVER 


Communication 
server 


9 LOGDI AG_DI R_DI BACCESS 


Database access 
modules 


Minor Type 13 - Network Management System (NMS) 




Subtype JOBFORMATTER Define 


Meaning 


0 LOGDIAG_NMS_OTHER 


Miscellaneous entries 


1 LOGDIAG_NMS_LCF 


Local Control Facility 
entries 


2 LOG D 1 AG_N M SJM C F 


Network Control 
Facility entries 


3 LOGDIAG_NMS_SNMP 


Entries from the 
SNMP agent 


Minor Type 16 - Systems Network Architecture (SNA) 




Retrieve all diagnostic information by using the LOG DIAG SNA command of 
LOGANALYZER. 
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Table 12-152. Major Type 19-Minor Types 1, 4, 5, 6, 7, 11, 12, 13, and 16 (cont.) 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


I Distributed Systems Service (LOGDIAGDSS) 

4 Message Handling System (LOGDIAGMHS) 

5 Open Systems Interconnection (LOGDIAG OSI) 

6 TCP/I P (LOGDI AGJTCPI P) 

7 Network-Independent Software (LOGDIAG NIS) 

I I Host LAN Connection (LOGDIAG HLCN) 

12 OSI Directory (LOGDI AG_DIR) 

13 Network Management System (LOGDI AG NMS) 
16 Systems Network Architecture (LOGDI AG SNA) 


Words 


Description 


5-end 


Variable-length data. Field [15:4] of Word 4 specifies the format of the variable-length data. If 
the format is raw binary data, then field [47:13] of Word 4 specifies the length of the data in 
bytes. If the format is formatted text, then field [47:13] of Word 4 specifies the total number 
of lines of text. The first byte of each line stores a value indicating the length of the line in 
bytes, not including the length byte itself. 
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Major Type = 25 Host LAN Connection (LOGMAJ__HLCN) 

Log entries of Major Type 25 record system actions that are related to the Host LAN 
Connection (HLCN) product. 

The LINK words used in Major Type 25 log entries follow the same format as standard 
LINK words, except that the length field can be expressed in either bytes or words. In 
Tables 12-153 through 12-158, the individual log entry descriptions specify the units 
used for each LINK word. The following is the format: 

Field Meaning 

[39:20] Length of this item, in bytes or words 

[19:20] Index of word in log entry where this item starts. It is found in the 

variable part of the log entry. 



Table 12-153. Major Type 25-Minor Type 1 



Minor Type = 


1 Change Network Processor (LOGHLCN_CHANGE_NP); 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Network processor unit number 


5 


LINK to firmware file title. The LINK length is in units of bytes. If the 
firmware file title has not been changed, the length is 0. The file title is in 
display form. 


6 


LINK to node address. The LINK length is in units of bytes. If the node 
address has not been changed, the length is 0. The node address is in 
EBCDIC form. 


7 


LINK to network number. The LINK length is in units of bytes. If the 
network number has not been changed, the length is 0. The network 
number is in EBCDIC form. 


8 


LINK to internal network number. The LINK length is in units of bytes. If 
the internal network number has not been changed, the length is 0. The 
network number is in EBCDIC form. 


9 


[ 3: 4] FRAME 

-1 = Frame was not changed. 

1 = ETHERNET 802.3 

2 = ETHERNETJI 


10-end 


Variable-length data pointed to by the LINKs in this record 
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Table 12-154. Major Type 25-Minor Type 2 



Minor Type 


= 2 Network Processor Report (LOGHLCNNPREPORT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Network processor unit number 


5 


LINK to report. The LINK length is in units of bytes. The report is in 
EBCDIC form. 


6-end 


Variable-length data pointed to by the LINKs in this record 


Table 12-155. Major Type 25-Minor Types 3 and 4 


Minor Type 
Minor Type 


= 3 Add NETACCESSPOINT (LOGHLCN ADD NETACCESSPOINT) 

= 4 Change NETACCESSPOINT (LOGHLCN_CHANGE_NETACCESSPOI NT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to NETACCESSPOINT name. The LINK length is in units of bytes. 
The NETACCESSPOINT name is in EBCDIC form. 


5 


LINK to network processor unit number list. The LINK length is in units of 
words. Within the unit number list, each word stores the unit number of a 
single network processor. 


6-end 


Variable-length data pointed to by the LINKs in this record 
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Table 12-156. Major Type 25-Minor Type 5 



Minor Type = 


5 Delete NETACCESSPOINT (LOGHLCN_DELETE_NETACCESSPOI NT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to NETACCESSPOINT name. The LINK length is in units of bytes. 
The NETACCESSPOINT name is in EBCDIC form. 


5-end 


Variable-length data pointed to by the LINKs in this record 


Table 12-157. Major Type 25-Minor Type 6 


Minor Type = 


6 Reset Router (LOGHLCN_RESET_ROUTER) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


Network processor identification, expressed as an integer 


Table 12-158. Major Type 25-Minor Type 7 


Minor Type = 


7 Network Manager Report (LOGHLCNNMREPORT) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4 


LINK to network manager report. The LINK length is in units of bytes. The 
report is in EBCDIC form. 
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Major Type = 27 TCP/IP (LOGMAJ_TCPIP) 

Log entries of Major Type 27 record all nondiagnostic commands, responses, and 
reports generated by the TCP/IP network provider. 

The BNA Version 2 Network Encoded Messages Programming Reference Manual, 
Volume 2 explains the format of the log records after Word 3. 



Table 12-159. Major Type 27-Minor Types 1 through 11 



Minor Type 




1 Transmission Control Protocol (TCP) layer 


Minor Type 




2 Internet Protocol (IP) layer 


Minor Type 




3 Address Resolution Protocol (ARP) function 


Minor Type 




4 Route Information Protocol (RIP) function 


Minor Type 




5 User Datagram Protocol (UDP) layer 


Minor Type 




6 Internet Control Message Protocol (ICMP) function 


Minor Type 




7 TCP Manager (TCPMGR) function 


Minor Type 




8 Connection Open and Close (PIM) reports 


Minor Type 




9 Reserved 


Minor Type 




10 Entries Generated During the Process of an SNMP Command 


Minor Type 




11 Miscellaneous (OTHER) 


Words 




Description 


0-3 




As described in Table 12-2, "First Four Log Entry Words" 


4- end 




Variable-length data. 
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Major Type = 28 Network Management (LOGMAJNMS) 

Log entries of Major Type 28 record all nondiagnostic commands, responses, and 
reports generated for Network Management. 

The BNA Version 2 Network Encoded Messages Programming Reference Manual, 
Volume 2 explains the format of the log records after Word 3. 



Table 12-160. Major Type 28-Minor Types 1 through 4 



Minor Type = 


1 Local Control Facility (LCF) 


Minor Type = 


2 Network Control Facility (NCF) 


Minor Type = 


3 SNMP Agent (SNMP) 


Minor Type = 


4 Miscellaneous (OTHER) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4- end 


Variable-length data. 
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Major Type = 30 Systems Network Architecture (LOGMAJSNA) 

Log entries of Major Type 30 record all nondiagnostic commands, responses, and 
reports generated for Systems Network Architecture (SNA). 



Table 12-161. Major Type 30-Minor Types 1 through 3 



Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 
Minor Type = 


1 Noteworthy network event (REPORT) 

2 Network frame reported as a result of the TRACE + command 

3 Unexpected fault condition (ERROR) 

4 Solicited status request and response (INQUIRY) 

5 Solicited action request and response (COMMAND) 

6 Miscellaneous (OTHER) 


Words 


Description 


0-3 


As described in Table 12-2, "First Four Log Entry Words" 


4- end 


Variable-length data. 
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System Stability Reporting 



One of the fundamental performance characteristics of a computing system is its 
stability. Stability is a measure of how consistently a system provides service to users. 
System stability is of concern to customers because system downtime can affect the 
business value of time-critical applications. Computer vendors in turn are concerned 
about system stability because it affects customer satisfaction. 

To promote system stability, it is essential that the computer vendor collect reliable 
information about the stability of systems at customer sites. This information can 
be used to identify areas in the hardware and software where reliability could be 
enhanced. 

System stability reporting (SSR) is a process by which Unisys Corporation collects 
system stability information from customer sites. The information collected is known 
as SSR data. As of the current Mark release, SSR has been implemented for A 12, A 15, 
A 16, and A 17 systems. 

The following are the elements of the SSR process: 

• Automatic system stability logging, which stores information about service 
interruptions in the stability log. The stability log is discussed under 
"Understanding the Stability Log" in this section. 

• RSVP messages, which prompt an operator to enter information after each 
halt/load. These are discussed under "Recording the Initial Halt/Load Description" 
in this section. 

• Customer and Unisys evaluation. The customer and the Unisys site representative 
each use the SSR interactive support tool (ISTUTILITY) to review and comment 
on the contents of the stability log. ISTUTILITY is discussed under "Viewing and 
Commenting On Stability Data" in this section. 

• Data transfers. In the United States, the customer periodically transmits a copy 
of the stability log to the Unisys customer service center (CSC), using a data 
communications link that exists in the maintenance subsystem of the customer 
system. On A 16 systems, customers can use ISTUTILITY to manually initiate 
data transfers or to schedule automatic data transfers at specified intervals. If 
you use ISTUTILITY on an A 12, A 15, or A 17 system, contact your Unisys site 
representative for information about how to transfer stability data. 

Understanding the Stability Log 

The stability log is a file dedicated solely to storing stability information about the 
system. The stability log is separate from the system summary log (SUMLOG). 
Because the stability log is dedicated to stability information, it can store information 
covering a long period of time while still remaining a manageable size. 
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Structure and Capacity 

The stability log is of a fixed size, and is divided into several sections that also have a 
fixed size. After each section becomes full, the system begins overwriting the oldest 
entries in the section. The stability log has the following capacities for the various 
types of information stored: 

• Up to 300 halt records can be stored. For information about the contents of halt 
records, refer to "Reviewing and Entering Halt Data" later in this section. 

• Up to 365 days' worth of internal failure summaries can be stored. For information 
about the contents of internal failure summaries, refer to "Viewing Internal 
Failure Summaries" later in this section. 

• Up to 30 different daily comments can be stored. The comments can be spread 
over a period of more than 30 days if comments are not entered every day For 
information about daily comments, refer to "Reviewing and Entering Daily 
Comments" later in this section. 

Where the Log Resides 

The stability log resides on the halt/load family that was in effect at the time of the 
most recent halt/load. The stability log file is titled *SYSTEM/STABILITYLOG. The 
stability log file cannot be removed. 

If the HLUNIT (Specify Halt/Load Unit) system command is used to specify a new 
haltAoad family, then a new stability log is opened on the new halt/load family after the 
next halt/load. As a result, any family that has been used as a halt/load family might 
contain a stability log file. If, following a halt/load, the system finds an invalid stability 
log file titled *SYSTEM/STABILITYLOG on the halt/load family, then the system 
renames the file *SYSTEM/STABILITYLOG/BAD and opens a new stability log file 
titled *SYSTEM/STABILITYLOG. 

When the system opens a new stability log file on a new halt/load family after a 
halt/load, the system is unable to complete the halt record for the haltAoad until a 
subsequent HLUNIT system command and haltAoad cause the stability log file on the 
original family to be used again. If the haltAoad that returns the original stability log 
to use takes place within 12 hours of the original haltAoad, the system displays the 
RSVP questions described under "Recording the Initial Halt/Load Description," later 
in this section. If the elapsed time has been greater than 12 hours, however, the system 
displays no RSVP messages, because the operator might be unsure which haltAoad the 
RSVP messages refer to. 

Before changing to a new haltAoad family, transfer the data in the stability log to the 
customer support center (CSC). On A 16 systems, you can initiate a manual data 
transfer from the Transfer Schedule Manual screen of ISTUTILITY, as discussed under 
"Initiating and Scheduling Data Transfers" later in this section. 

If you create a haltAoad family for a new system by copying all SYSTEM files from 
the haltAoad family of an existing system, remove the *SYSTEM/STABILITYLOG 
file from the new family before that family is used as a haltAoad family. This step is 
advisable because the old *SYSTEM/STABILITYLOG file contains stability data for 
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the old system. By removing this file, you ensure that the MCP creates a new stability 
log when the MCP is first initialized from the new halt/load family. 

Recording the Initial Halt/Load Description 

Following a halt/load, the system uses RSVP messages to prompt the operator to enter 
information about whether the halt/load was scheduled, and whether the halt/load was 
attributed to the customer or to a problem in a Unisys product. The system records the 
operator responses in the stability log. The customer and the Unisys representative 
can use ISTUTILITY later to expand or modify this basic information, as discussed 
under "Reviewing and Entering Halt Data" later in this section. 

The RSVP messages are as follows: 

• After the halt/load, a process with the following RSVP message appears in the W 
(Waiting Mix Entries) system command display: 

MLSACCEPT:WAS THIS HALTLOAD A SCHEDULED INTERRUPTION ? (YES OR NO) 

Scheduled interruptions include interruptions for maintenance purposes, such as 
changing the microcode or MCP Unscheduled interruptions include fatal memory 
dumps and interruptions caused by power failures. The operator can respond to 
this message with an AX (Accept) system command of the form <mix number> AX 
YES or <mix number> AXNO. 

• A process with the following RSVP message then appears in the W command 
display: 

MLSACCEPT: SHOULD THE HALTLOAD BE ALLOCATED TO UNISYS ? (YES OR NO) 

The operator must enter his or her perception of whether the interruption is due to 
a Unisys hardware or software failure or due to some other factor that is peculiar 
to the site, such as a power failure. Once again, the operator can respond with a 
<mix number> AX YES or a <mix number> AXNO command. 

The operator can cause the system to skip the second RSVP message by entering a 
complex response to the first RSVP message. The complex response contains two YES 
or NO answers, separated by a space or a comma (,). For example, if the operator 
answers the first RSVP message with <mix number> AX YES YES, then the system 
records a YES response to both questions but never actually displays the second RSVP 
message. 
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Viewing and Commenting On Stability Data 

The interactive support tool (ISTUTILITY) is a utility program that allows you to 
review automatically collected SSR data and to add comments of your own. For 
example, you can use ISTUTILITY to do any of the following: 

• Record whether a system halt is caused by an unplanned system failure or a 
planned halt/load to reload the operating system. 

• Record whether a system halt is the result of an equipment failure or the result of 
losing electrical power to the system. 

• Record observed symptoms relating to a particular halt. 

• Record the amount of time the system is unavailable for production use. 

• Identify a particular system element whose failure is suspected of having caused a 
system halt. 

• Correlate two or more halts that have similar symptoms. 

Installing ISTUTILITY 

ISTUTILITY is part of the general A Series system software release. You can install 
ISTUTILITY using the Simple Installation (SI) program described in the A Series 
Software Release Installation Guide. Simple Installation (SI) installs ISTUTILITY as 
part of the System Software Utilities (SSU) product. 

SI installs the following files, which must both be present in order for 
ISTUTILITY to function: SYSTEM/ISTUTILITY and SYSTEM/SSRSUPPORT. 
SI also marks SYSTEM/SSRSUPPORT as a privileged program, and associates 
SYSTEM/SSRSUPPORT with the SL function name SSRSUPPORT. 

Installing the Transfer Schedule Feature 

A 16 systems support automatic scheduled transfers of system stability data to the 
Unisys customer support center (CSC). To make use of the transfer schedule feature, 
you must first configure the system console and the A Series host properly. You can use 
the following steps to configure the system console to support the transfer schedule 
feature: 

1. Install console software of level 12.008 or greater. Refer to the A 161 A 19 System 
Console Operations Guide for details. 

2. Create a console network description file for system stability reporting. To do 
this, contact a Unisys customer support representative, who will assist with the 
creation of a network description file. The customer support representative might 
be able to provide a floppy disk with an appropriate network description file. You 
can use the Transfer function of the Installer console screen to copy this file onto 
the fixed disk. 
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You might have to make minor changes to an existing network description file, 
such as changes to the data terminal equipment (DTE) address. Alternatively, 
you might have to create a new network description file. You can modify or create 
network description files by using the Configure Network field on the RSC Connect 
console screen. 

3. Declare the SSR network description file name by using the Change SSR Network 
field on the RSC Connect screen. The SSR network name does not have to match a 
configured remote supervisory console (RSC) network name. 

4. Set the Auto Dial Enable field on the Network-Layer 2 console screen to a value of 
2 for SSR network description files. 

5. Declare the system console transport (SCX) unit in the peripheral configuration 
diagram (PCD). Declare the SCX unit with unit position 14 on the CON1 control. 
Then attach the new PCD to the IOM or IOMs by using the IOM Features console 
screen. 

You can use the following steps to configure the A Series host to support the transfer 
schedule feature: 

1 . Load the system from the console. 

2. Acquire the SCX unit into the group by using the ACQUIRE SC <unit number> 
form of the ACQUIRE (Acquire Resource) system command. If the SCX is not 
ready, then ready the unit by using the RY SC <unit number> form of the RY 
(Ready) system command. 

3. Verify that the SCX unit is present by entering the PER SC form of the PER 
(Peripheral Status) system command. The SCX unit, if it is present, is labeled 
CMPLINK. 

4. Scan the MSG (Display Messages) system command output until you see the 
following message: 

CONSOLE TRANSPORT SERVICE IS NOW AVAILABLE. 

5. Initiate a manual data transfer to verify that the console and the system hardware 
and software are functioning properly. You can initiate the manual data transfer 
from the Transfer Schedule Manual screen of ISTUTILITY. The following message 
appears in the MSG display within one or two minutes of the initiation: 

STABILITYLOG MANUAL TRANSFER INITIATED 

6. If the transfer completes successfully, the following message appears in the MSG 
display: 

STABILITYLOG TRANSFER SUCCESSFUL 

Once a manual transfer has completed successfully, define a schedule for automatic 
data transfers with the Auto Transfer Schedule menu of ISTUTILITY. 
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7. If the transfer does not complete successfully, the following message appears in the 
MSG display: 

STABILITYLOG TRANSFER FAILED 

Contact the CSC for assistance in remedying the problem. 



Initiating ISTUTILITY 

You can use ISTUTILITY at any T27 or compatible terminal. To run ISTUTILITY, log 
on to a CANDE or MARC session and enter the following command: 



RUN *SYSTEM/ISTUTILITY ON <family> 



If you enter this command in MARC, you should enter it in the Action field rather than 
the Choice field. 



Using ISTUTILITY Screens 

Every screen used in ISTUTILITY contains an Action field and an XMIT Here field. 
These fields are illustrated in Figure 13-1. 



r 



Interactive Support Tool 

[ ] Action 

Redisplay Help Exit 



Tue Nov 19 17:37:17 1991 



Main Menu 



[1] Select Function 
** 1 - Review/ Evaluate Halt Data 

2 - View Summary Data 

3 - Review/Enter Daily Comment 

4 - Collection Configuration 

5 - Transfer Schedule 



XMIT here [e] 

Figure 13-1. Main Menu 



The Action field is a 1 -character field that accepts the first character of the actions 
listed immediately below it. 
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Note: On most screens, you can leave the Action field blank, in which case 
the next screen in the menu sequence appears when you press the 
Transmit key. However, you must make an entry in the Action field to 
exit comment screens such as the Daily Comment screen. 

The following are the actions available from most screens, and their effects: 
Action Effect 

Cancel Ignores any data that you have typed into fields on the screen. 

Cancels the activity that is normally initiated by the current screen 
and redisplays the screen that initiated the current activity. This 
screen might be the previous screen, or it might be one several 
screens back. 

Exit Inspects the data on the screen, accepts the data if valid, and exits 

ISTUTILITY. The user is returned to the environment from which 
ISTUTILITY was executed (for example, CANDE or MARC). 

Help Temporarily saves any data you have typed on the screen and 

displays help text for the current screen. You can return to the 
current screen by transmitting the help screen with a C (for cancel) 
or a blank in the Action field. 

Previous Inspects the data on the current screen. If the data is valid, accepts 

the data and returns to the screen displayed prior to this one. If the 
data is invalid, redisplays the current screen with an error message 
so that you can correct the unacceptable data. 

Redisplay Ignores the data on the screen. Redisplays the current screen as it 

was originally displayed. 

Below the Action field, many of the screens include one or more special-purpose fields. 
For example, the Main Menu includes the Select Function field. 

After making all your entries to the Action field and any special-purpose fields, you 
should place the cursor in the XMIT Here field before transmitting. This cursor 
position ensures that a valid screen is transmitted to the system. 



Using the Main Menu Screen 

When ISTUTILITY initiates, it displays the Main Menu screen shown in Figure 13-1. 
From the Main Menu screen, you can choose any of the following functions: 

Selection Meaning 

Review/Evaluate Halt Data Review or add information to halt/load descriptions 

automatically collected by the system. 

View Summary Data Review internal fault descriptions automatically collected by 

the system. 

Review/Enter Daily Comment Enter free-formatted comments describing any issues related 

to system stability for a particular day. 

continued 
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continued 



Selection 

Collection Configuration 
Transfer Schedule 



Meaning 

Specify which types of halts the customer is asked to review 
when using ISTUTILITY. This menu selection is intended for 
use by the Unisys representative. 

Initiate a manual transfer of stability data to a CSC, or create 
a schedule for automatic data transfers. This selection is 
currently available only on A 16 systems. 



The following subsections describe the functions provided by these menu selections in 
more detail. 



Reviewing and Entering Halt Data 

You can use the Review/Evaluate Halt Data selection on the Main Menu to review halt 
item descriptions. This selection causes ISTUTILITY to display the Review Halt Data 
screen shown in Figure 13-2. 



Interactive Support Tool 

Review Halt Data 

[ ] Action 

Redisplay Cancel Help Exit 



Fri Jul 27 12:10:45 1990 



[1] Select review type 

1 - Review site evaluation incomplete halt records. 

2 - Review Unisys evaluation incomplete halt records. 

3 - Review halts attributed to the site. 

4 - Review halts attributed to Unisys. 

5 - Manual selection of halts for review. 



Halt data is available for the period of 

03/19/1990 to 07/25/1990 

(mm/dd/yyyy) 

Incomplete halt records: 
152 Site evaluations 153 Unisys evaluations 



XMIT here [@] 



Figure 13-2. Review Halt Data Screen 



Selecting Criteria for Halt Record Display 

You can use the Select Review Type field of this screen to specify the types of halt 
•records to be reviewed. You can enter 1 to select those records that require customer 
evaluation, or 2 to select those records that require Unisys evaluation. Not all halt 
records require evaluation; refer to "Configuring the Halt Review Criteria" in this 
section for further information. 

Entering 3 or 4 selects halt records based on whether they are attributable to the 
customer or to Unisys. Entering 5 (for Manual Selection of Halts for Review) causes 
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the display of the Halt Selection Items screen, which allows you to specify additional 
criteria for the selection of halt records. 



Reviewing the Halt Records 

After you finish selecting the criteria for halt record display, ISTUTILITY begins 
displaying a series of halt records. Each halt record display begins with two Collected 
Halt Status screens that display the information automatically collected by the system. 
This information includes the following items: 

• The date and time the system recovered from the halt. 

• The halt type. The halt type indicates whether the halt is initiated internally by 
the hardware or software, initiated by manual intervention by the operator, or 
initiated by an unknown cause. 

• The system command used to reload the system. 

• Whether the halt was scheduled or unscheduled, and whether the halt is 
attributable to Unisys or the site. These items of information are based on the 
operator responses discussed under "Recording the Initial Halt/Load Description" 
in this section. 

• Whether or not the ODT was responding to the mainframe at the time of the halt. 

• Whether or not the system running indicator was present at the time of the halt. 

• The number of processors operating in the system at the time of the halt. 

• The MCP level in use at the time of the halt. 

• Whether or not the halt has been evaluated by Unisys. 

• Whether or not the halt has been evaluated by the site. 

• Whether or not halt comments have been entered by either Unisys or the site. 

• The number of minutes the MCP was running as a single-processor system before 
the system halted. 

• The number of minutes the MCP was running as a multiprocessor system before 
the system halted. 

• The primary reload time. This is the time taken to restart the MCP 

• The secondary reload time. This is the time taken to restart and recover user 
applications necessary for production to begin. 

• The general, and if known, the specific system element that caused the halt. This 
might be a hardware or software component. 

• Whether or not a halt is believed to be related to another halt. 

After viewing the first Collected Halt Status screen for a halt, you can advance to the 
next screen by transmitting the current screen with a blank in the Action field. After 
viewing the second Collected Halt Status screen, you can can again transmit the blank 
action to advance to the Halt Evaluations screen. 
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Reviewing and Entering the Halt Evaluation Data 

After the last of the Collected Halt Status screens for a halt record, ISTUTILITY 
displays the Halt Evaluations screen. This screen enables you to review or enter site 
evaluation information for the halt, and to review Unisys evaluation information for 
the halt. Once you transmit the Halt Evaluations screen, ISTUTILITY displays several 
screens including fields for the following types of evaluation information: 

• Whether the halt is scheduled or not scheduled. 

• Whether the halt is attributable to Unisys, the customer site, or an unknown 
source. 

• The impact of the halt on the site. Measures of impact are 

- None. The halt occurred when the system was not in production. 

- Minimal. The halt caused very little disruption. 

- Moderate. The halt occurred while the system was not in prime production 
time. 

- Severe. The halt occurred while the system was in prime production time. 

• Whether the halt was deferred or not. A deferred halt occurs when, in response to 
a fault condition in the system, a halt is postponed to a less disruptive time. 

• The system activity occurring when the halt happened. For example, this activity 
could be any of the following: 

- Normal production 

- Changing the physical hardware configuration 

- Changing the logical configuration of the software 

- Performing maintenance of system elements 

• The general, and if known, the specific system element that caused the halt. This 
might be a hardware or software component. 

• The estimated time that the system is down. Downtime is the elapsed time that the 
system is unavailable for processing. 

• The RESPOND reference number assigned by Unisys. 

• The CSC CONTACT number that Unisys assigns if the support center is contacted. 

• The UCF number that Unisys assigns if a UCF is submitted against the halt. 

• Identification of a related halt, if there is one. The related halt identification 
consists of the site identifier assigned by Unisys, the system identifier, and the halt 
number. 

When you are first entering evaluation information for a particular halt, you should 
fill out the required fields on each screen and leave the Action field blank. When you 
transmit the screen, ISTUTILITY displays the next screen in the sequence. 

When you complete the last screen in the sequence, ISTUTILITY returns you to the 
Halt Evaluations screen for the current halt. You can then step through the sequence 
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of screens again to review the information you previously entered. Simply transmit 
each screen with the Action field left blank to review the next screen in the sequence. 

While you are entering halt evaluation information, you might wish to also enter a halt 
comment. This procedure is described in the following subsection. 

When you have entered all the information you wish to for a given halt, you can 
advance to the next halt by using the Next Halt action, or by entering 3 (for Continue) 
in the Select Function field of the Halt Evaluations screen. 

To stop evaluating halts, you can use the Cancel action or enter 4 (for Complete) in the 
Select Functions field of the Halt Evaluations screen. Or, you can use the Exit action to 
exit ISTUTILITY. 



Entering Halt Comments 

You might wish to enter free-formatted comments about the halt. Such comments can 
describe specific conditions under which the halt occurred. Comments can also describe 
any symptoms of the problem causing the halt or any trouble encountered in bringing 
the system back up. 

To enter free-formatted comments about a halt, you must enter an A for Add Comment 
in the Action field of the Collected Halt Status screen, the Halt Evaluations screen, or 
any of the subsequent screens in the sequence. This action causes the Halt Comment 
screen to be displayed. You can enter your comments on this screen. 

If you leave the Action field on the Halt Comment screen blank, then ISTUTILITY 
simply redisplays the Halt Comment screen when you transmit. You can then revise 
your comments if desired. When you are satisfied with your comments, you should 
transmit the screen with a D for Done in the Action field. The Done action returns you 
to the previous screen. 

Viewing Internal Failure Summaries 

You can use the View Summary Data selection on the Main Menu to view summaries 
of internal system failures. This selection causes ISTUTILITY to display the View 
Summary Data Screen shown in Figure 13-3. 
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Interactive Support Tool 



Fri Jul 27 12:11:06 1990 



View Summary Data 



[ ] Action 

Redisplay Cancel Help Exit 



Summary data is available for the period of 



03/18/1990 to 07/27/1990 



View summary data for the period of 



[ 



] to [ 



] 



(mm/dd/yyyy) 
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Figure 13-3. View Summary Data Screen 



System delays are the only type of failure currently recorded. A delay is a time interval 
in which no programs are being processed except those programs supporting the 
diagnostic or recovery work. Delays are recorded when they exceed 10 seconds, as in 
the case of a nonfatal memory dump. Delays are also recorded when the accumulation 
of multiple delays exceeds 3 minutes in a given hour. 

You can use the View Summary Data screen to select the range of dates for which you 
want to view summaries. After you transmit this information, ISTUTILITY displays a 
series of Summary Data screens. Each Summary Data screen displays information 
about all failures of a given type that occurred on a particular day. For example, all 
system delays caused by the same system element on the same day are summarized on 
a single Summary Data screen. 

The Summary Data screens display the following items: 

• The date for which the failures are summarized. 

• The failure type being summarized. 

• If applicable, the system element that caused the failure. 

• If known, the reason for the failure. For delays, the reason for the delay is given. 

• The number of failure occurrences in this category that occurred on the indicated 



• For the failure type of delay, the accumulated duration of delays, measured in 
seconds, for the specified date. 



date. 
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Reviewing and Entering Daily Comments 

Daily comments are free-formatted comments that you can use to record any system 
activity or circumstances related to system stability. You can use the Review/Enter 
Daily Comment selection on the Main Menu to review, add, or update daily comments. 
This selection causes ISTUTILITY to display the Review Daily Comments screen 
shown in Figure 13-4. 



r 



Interactive Support Tool Fri Jul 27 12:11:17 1990 

Review Daily Comments 

[ ] Action 

Add comment Redisplay Cancel Help Exit 



Daily comments are available for the period of 
03/18/1990 to 03/20/1990 



View/enter daily comments for the period of 
[ ] to [ ] 

(mm/dd/yyyy) 



XMIT here [P] 

Figure 13-4. Review Daily Comments Screen 



If you are interested in adding or modifying daily comments, you should 

• Enter A (for Add comment) in the Action field. 

• Enter a range of dates in the fields below the View/enter daily comments for the 
period of prompt. 

• Transmit the screen. 

ISTUTILITY responds by displaying a series of Daily Comment screens, one for each 
date in the range. On each screen, an input field appears that enables you to enter 
comments or modify existing comments. When you transmit a Daily Comment screen 
with a D (for Done) in the Action field, ISTUTILITY displays the Daily Comment 
screen for the next date. 

If you are interested in viewing comments, and are sure that you do not want to modify 
any of the comments, then you should transmit the Review Daily Comments screen 
with a date range filled in and the Action field left blank. ISTUTILITY displays a series 
of Daily Comment screens that list the comments without allowing the comments to be 
modified. 
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Configuring the Halt Review Criteria 

A Unisys representative can specify the criteria for halt evaluation collection by 
entering the Collection Configuration selection on the Main Menu. This entry causes 
the display of the Collection Configuration screen shown in Figure 13-5. 



Interactive Support Tool Fri Jul 27 12:11:28 1990 

Collection Configuration 

[ ] Action 

Redisplay Cancel Help Exit 



Site review will be requested for: 

Scheduled halts attributed to Unisys. 
Scheduled halts attributed to the site. 
Unscheduled halts attributed to Unisys. 
Unscheduled halts attributed to the site. 



Unisys review will be requested for: 



Scheduled halts attributed to Unisys. 
Scheduled halts attributed to the site. 
Unscheduled halts attributed to Unisys. 
Unscheduled halts attributed to the site. 
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Figure 13-5. Collection Configuration Screen 

A Unisys representative uses the Collection Configuration screen to select the types of 
halts you are asked to review when you enter 2 (Review Site Evaluation Incomplete 
Halt Records) on the Review Halt Data screen. Additionally, you can use the Collection 
Configuration screen to add to the types of halts that you review. The types of halts to 
select from are the following: 

• Scheduled halts attributable to Unisys 

• Scheduled halts attributable to the customer site 

• Unscheduled halts attributable to Unisys 

• Unscheduled halts attributable to the customer site 



Initiating and Scheduling Data Transfers 

On A 16 systems with the transfer schedule feature installed, you can use the Transfer 
Schedule selection on the Main Menu to transfer data to a CSC. For information about 
how to install the Transfer Schedule feature, refer to "Installing the Transfer Schedule 
Feature" earlier in this section. The Transfer Schedule selection causes ISTUTILITY 
to display the Transfer Schedule screen shown in Figure 13-6. 
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Interactive Support Tool 



Wed Nov 20 14:14:50 1991 



Transfer Schedule 



[ ] Action 

Redisplay Cancel Help Exit 



[1] Select transfer action 

1 - Set up auto transfer schedule 

2 - Display transfer status 

3 - Set up manual transfer 
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Figure 13-6. Transfer Schedule Screen 



The following are the values you can enter in the Select Transfer Action field, and their 
effects: 



Value 

1 



Description 

ISTUTILITY displays the Transfer Schedule Auto screen. You can use the 
Transfer Schedule Auto screen to enable or disable automatic data 
transfers, to specify the time of day that transfers are to occur, and to 
specify whether the intervals between transfers are to be measured in units 
of weeks or months. ISTUTILITY displays further screens that ask you to 
specify the number of weeks or months between transfers, and the days of 
the week or month when data should be transferred. 

ISTUTILITY displays the Transfer Schedule Status screen. The Transfer 
Schedule Status screen provides information about the data transfer 
currently in progress (if any), the last data transfer to be completed, and the 
next data transfer that is scheduled. You can also use this screen to specify 
whether data transfer failures result in a waiting entry being displayed at 
the ODT. 

On the Transfer Schedule Status screen, the Calendar Date of Last 
Completed Auto Transfer field shows the date of the last completed 
automatic transfer. This field is updated after each successful automatic 
transfer. You can also manually alter the date in this field if you want to 
retransmit some of the data, or if you want to compensate because the 
system date was recently reset backwards. If this date has been manually 
modified, two asterisks (**) appear next to it on the screen. The asterisks 
disappear after the next successful automatic transfer. 



continued 
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continued 

Value Description 

3 ISTUTILITY displays the Transfer Schedule Manual screen. The Transfer 

Schedule Manual screen enables you to initiate the immediate transfer of 
stability data to the CSC. You specify the oldest stability data to be 
transferred by entering a date in the Enter the Starting Date field. If you fill 
this field with blanks, the entire stability log is transferred. 

If an automatic transfer has already been attempted on the current day, then no 
additional automatic transfers are initiated on the current day. This restriction applies 
even if the automatic transfer failed or if you use ISTUTILITY to change the schedule 
for automatic transfers. 

Automatic transfers can occur within a transfer window. This window begins at the 
scheduled transfer time and ends 2 hours and 50 minutes later. If the first attempt at 
an automatic transfer fails, then the system might wait for a while and retry at a later 
time within the transfer window. The system does not attempt an automatic transfer 
or a retry of an automatic transfer at any time outside this window. 

You can initiate a manual transfer at any time, except when a manual or automatic 
transfer is already in progress, or when an automatic transfer is waiting to retry after a 
failure. A manual transfer terminates immediately if it fails, and is not retried. 

If a manual transfer is in progress at the time that an automatic transfer is scheduled 
to begin, then the automatic transfer is initiated immediately after the manual transfer 
completes. 

If a transfer is currently in progress, any attempt to modify the calendar date of the 
last completed automatic transfer is rejected. 

If an automatic transfer fails because it is unable to connect to the customer support 
center, an automatic transfer is scheduled for the following day at the regularly 
scheduled time. An automatic transfer continues to be scheduled every day until one of 
the following occurs: 

• An automatic transfer succeeds. 

• An automatic transfer fails for some reason other than a connect error. 

• A new automatic transfer schedule is entered by way of the ISTUTILITY. 

Note: Reentering the current automatic transfer schedule has the side effect 
of stopping the daily rescheduling after a connect failure. However, 
there is no way to permanently turn off the mechanism that does this 
daily rescheduling. 
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Understanding Railroad Diagrams 



What Are Railroad Diagrams? 



Railroad diagrams are diagrams that show you the rules for putting words and symbols 
together into commands and statements that the computer can understand. These 
diagrams consist of a series of paths that show the allowable structure, constants, and 
variables for a command or a statement. Paths show the order in which the command 
or statement is constructed. Paths are represented by horizontal and vertical lines. 
Many railroad diagrams have a number of different paths you can take to get to the 
end of the diagram. For example: 

— REMOVE 



SOURCE 
1- OBJECT 



I 



If you follow this railroad diagram from left to right, you will discover three acceptable 
commands. These commands are 

• REMOVE 

• REMOVE SOURCE 

• REMOVE OBJECT 

If all railroad diagrams were this simple, this explanation could end here. However, 
because the allowed ways of communicating with the computer can be complex, 
railroad diagrams sometimes must also be complex. 

Regardless of the level of complexity, all railroad diagrams are visual representations of 
commands and statements. Railroad diagrams are intended to 

• Show the mandatory items. 

• Show the user-selected items. 

• Present the order in which the items must appear. 

• Show the number of times an item can be repeated. 

• Show the necessary punctuation. 



To familiarize you with railroad diagrams, this explanation describes the elements of 
the diagrams and provides examples. 

Some of the actual railroad diagrams you will encounter might be more complex. 
However, all railroad diagrams, simple or complex, follow the same basic rules. They 
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all consist of paths that represent the allowable structure, constants, and variables for 
commands and statements. 

By following railroad diagrams, you can easily understand the correct syntax for 
commands and statements. Once you become proficient in the use of railroad notation, 
the diagrams serve as quick references to the commands and statements. 

Constants and Variables 

A constant is an item that cannot be altered. You must enter the constant as it appears 
in the diagram, either in full or as an allowable abbreviation. If a constant is partially 
underlined, you can abbreviate the constant by entering only the underlined letters. In 
addition to the underlined letters, any of the remaining letters can be entered. If no 
part of the constant is underlined, the constant cannot be abbreviated. Constants can 
be recognized by the fact that they are never enclosed in angle brackets (< >) and are 
in uppercase letters. 

A variable is an item that represents data. You can replace the variable with data that 
meets the requirements of the particular command or statement. When replacing a 
variable with data, you must follow the rules defined for the particular command or 
statement. Variables appear in railroad diagrams enclosed in angle brackets. 

In the following example, BEGIN and END are constants while < statement list> is a 
variable. The constant BEGIN can be abbreviated since it is partially underlined. Valid 
abbreviations for BEGIN are BE, BEG, and BEGI. 

— BEGIN — statement 1 i st> — END 1 

Constraints 

Constraints are used in a railroad diagram to control progression through the diagram. 
Constraints consist of symbols and unique railroad diagram line paths. They include 



• 


Vertical bars 


• 


Percent signs 


• 


Right arrows 


• 


Required items 


• 


User-selected items 


• 


Loops 


• 


Bridges 



A description of each item follows. 
Vertical Bar 

The vertical bar symbol ( | ) represents the end of a railroad diagram and indicates the 
command or statement can be followed by another command or statement. 
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— SECONDWORD — ( — arithmetic expression? — ) 1 

Percent Sign 

The percent sign (%) represents the end of a railroad diagram and indicates the 
command or statement must be on a line by itself. 



Right Arrow 

The right arrow symbol (>) is used when the railroad diagram is too long to fit on one 
line and must continue on the next. A right arrow appears at the end of the first line, 
and another right arrow appears at the beginning of the next line. 



-»-<ari thmeti c expression? — ) 1 

Required Items 

A required item can be either a constant, a variable, or punctuation. A required item 
appears as a single entry, by itself or with other items, on a horizontal line. Required 
items can also exist on horizontal lines within alternate paths or nested (lower-level) 
diagrams. If the path you are following contains a required item, you must enter the 
item in the command or statement; the required item cannot be omitted. 

In the following example, the word EVENT is a required constant and < identifier > is 
a required variable: 

— EVENT — identifier? 1 

User-Selected Items 

User-selected items appear one below the other in a vertical list. You can choose any 
one of the items from the list. If the list also contains an empty path (solid line), none 
of the choices are required. A user-selected item can be either a constant, a variable, or 
punctuation. In the following railroad diagram, either the plus sign (+) or the minus 
sign (-) can be entered before the required variable < arithmetic expression>, or the 
symbols can be disregarded because the diagram also contains an empty path. 

— I 1— <ari thmeti c expression? 1 



— STOP 



-% 



— SCALERIGHT — ( — <ari thmeti c expression? — , 
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Loop 

A loop represents an item or group of items that you can repeat. A loop can span all or 
part of a railroad diagram. It always consists of at least two horizontal lines, one below 
the other, connected on both sides by vertical lines. The top line is a right-to-left path 
that contains information about repeating the loop. 

Some loops include a return character. A return character is a character — often a 
comma (,) or semicolon (;) — required before each repetition of a loop. If there is no 
return character, the items must be separated by one or more blank spaces. 

r* ; 1 

— <field value>— 1 1 



Bridge 

Sometimes a loop also includes a bridge, which is used to show the maximum number 
of times the loop can be repeated. The bridge can precede the contents of the loop, or it 
can precede the return character (if any) on the upper line of the loop. 

The bridge determines the number of times you can cross that point in the diagram. 
The bridge is an integer enclosed in sloping lines (/ \). Not all loops have bridges. Those 
that do not can be repeated any number of times until all valid entries have been used. 

In the first bridge example, you can enter LINKAGE or RUNTIME no more than two 
times. In the second bridge example, you can enter LINKAGE or RUNTIME no more 
than three times. 

— L/2\-,- LINKAGE -i— • 1 

L RUNTIME -J 



r*_ /2 \ 1 

— ' — I — LINKAGE ->— 1 1 

L- RUNTIME -I 

In some bridges an asterisk (*) follows the number. The asterisk means that you must 
cross that point in the diagram at least once. The maximum number of times that you 
can cross that point is indicated by the number in the bridge. 

— L T -/2*\- LINKAGE -,— 1 1 

L RUNTIME 1 

In the previous bridge example, you must enter LINKAGE at least once but no more 
than twice, and you can enter RUNTIME any number of times. 

The following figure shows the types of constraints used in railroad diagrams. 
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SYMBOL/ PATH 


EXPLANATION 


1 


Vertical bar. Indicates that the 
command or statement can be f ol 1 owed 
by another command or statement. 


°/o 


Percent sign. Indicates that the 
command or statement must be on a 
line by itself. 


> 

> 


Right arrow. Indicates that the 
diagram occupies more than one 
line. 


_^ required 


Required items. Indicates the 
constants, variables, and 
punctuation that must be entered 
in a command or statement. 




- YES - 

- NO — 




User-selected items. Indicates the 
items that appear one below the 
other in a vertical list. You 
select which item or items to include. 




< 1 




A loop. Indicates an item or group 
of items that can be repeated. 


L_ /2\ -L— 


A bridge. Indicates the maximum j 
number of times a loop can be 
repeated . 



Figure A-l. Railroad Constraints 



Following the Paths of a Railroad Diagram 

The paths of a railroad diagram lead you through the command or statement from 
beginning to end. Some railroad diagrams have only one path, while others have 
several alternate paths. The following railroad diagram indicates there is only one path 
that requires the constant LINKAGE and the variable < linkage mnemonic> : 

— LINKAGE — <linkage mnemom"c> 1 

Alternate paths provide choices in the construction of commands and statements. 
Alternate paths are provided by loops, user-selected items, or a combination of both. 
More complex railroad diagrams can consist of many alternate paths, or nested 
(lower-level) diagrams, that show a further level of detail. 

For example, the following railroad diagram consists of a top path and two alternate 
paths. The top path includes an ampersand (&) and the constants (that are 
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user-selected items) in the vertical list. These constants are within a loop that can be 
repeated any number of times until all options have been selected. The first alternate 
path requires the ampersand and the required constant ADDRESS. The second 
alternate path requires the ampersand followed by the required constant ALTER and 
the required variable <new value >. 



— & 



r 



TYPE - 
h ASCII 
BCL - 



- DECIMAL - 

- EBCDIC — 
HEX 



L- OCTAL - 

ADDRESS 

■— ALTER — <new value: 



Railroad Diagram Examples with Sample Input 

The following examples show five railroad diagrams and possible command and 
statement constructions based on the paths of these diagrams. 



Example 1 
<lock statement > 

— LOCK — ( — <file identifier — ) 



Sample Input Explanation 

LOCK (FILE4) LOCK is a constant and cannot be altered. Because no part 

of the word is underlined, the entire word must be entered. 

The parentheses are required punctuation, and FILE4 is a 
sample file identifier. 



Example 2 



<open statement > 

— OPEN 



C INQUIRY - 
L- UPDATE — I 



-<database name>- 



Sample Input Explanation 

OPEN DATABASE 1 The constant OPEN is followed by the variable DATABASE1 , 

which is a database name. 

The railroad diagram shows two user-selected items, 
INQUIRY and UPDATE. However, because there is an empty 
path (solid line), these entries are not required. 

continued 
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continued 
Sample Input 

OPEN INQUIRY DATABASE1 
OPEN UPDATE DATABASEl 



Explanation 

The constant OPEN is followed by the user-selected 
constant INQUIRY and the variable DATABASEl. 

The constant OPEN is followed by the user-selected 
constant UPDATE and the variable DATABASEl. 



Example 3 



< generate statement > 

— GENERATE — <subset= 



-r- NULL — 
L-< S ubset>- 



- AND - T -<subset>- J 

- OR — 



Sample Input 

GENERATE Z = NULL 

GENERATE Z = X 
GENERATE Z = X AND B 



GENERATE Z = X + B 



Explanation 

The GENERATE constant is followed by the variable Z, an 
equal sign (=), and the user-selected constant NULL. 

The GENERATE constant is followed by the variable Z, an 
equal sign, and the user-selected variable X. 

The GENERATE constant is followed by the variable Z, an 
equal sign, the user-selected variable X, the AND command 
(from the list of user-selected items in the nested path), and 
a third variable, B. 

The GENERATE constant is followed by the variable Z, an 
equal sign, the user-selected variable X, the plus sign (from 
the list of user-selected items in the nested path), and a 
third variable, B. 
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Example 4 

<entity reference declaration > 

— ENTITY REFERENCE -^entity ref ID>— ('— <class ID>— ) -i 



Sample Input 

ENTITY REFERENCE ADVIS0R1 (INSTRUCTOR) 



ENTITY REFERENCE ADVISOR1 (INSTRUCTOR), 
ADVISOR2 (ASST INSTRUCTOR) 



Explanation 

The required item ENTITY 
REFERENCE is followed by the 
variable ADVISOR1 and the variable 
INSTRUCTOR. The parentheses are 
required. 

Because the diagram contains a 
loop, the pair of variables can be 
repeated any number of times. 



Example 5 

— PS — MODIFY 



t— <request number> r 

I— <request number> <request number>— ' 



L- ALL 



"U 



EXCEPTIONS 



-<f i 1 e attribute phrase>- 



L773 



-<print modifier phrase>— ' 



Sample Input 

PS MODIFY 11159 

PS MODIFY 11159,11160,11163 

PS MOD 11159-11161 DESTINATION = 
"LP7" 

PS MOD ALL EXCEPTIONS 



Explanation 

The constants PS and MODIFY are followed 
by the variable 1 1159, which is a request 
number. 

Because the diagram contains a loop, the 
variable 11159 can be followed by a 
comma, the variable 11160, another 
comma, and the final variable 1 1 163. 

The constants PS and MODIFY are followed 
by the user-selected variables 
11159-11161, which are request numbers, 
and the user-selected variable DESTINATION 
= "LP7", which is a file attribute phrase. 
Note that the constant MODIFY has been 
abbreviated to its minimum allowable form. 

The constants PS and MODIFY are followed 
by the user-selected constants ALL and 
EXCEPTIONS. 
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A 

actual segment descriptor (ASD) 

A pointer to the location of a data or code item in memory or on a disk. 

ALGOL 

Algorithmic language. A structured, high-level programming language that provides 
the basis for the stack architecture of the Unisys A Series systems. ALGOL was the 
first block-structured language developed in the 1960s and served as a basis for such 
languages as Pascal and Ada. It is still used extensively on A Series systems, primarily 
for systems programming. 

ASD 

See actual segment descriptor. 

B 

BDLC 

See Data Link Control. 

BNA 

The network architecture used on A Series, B 1000, and V Series systems as well as 
CP9500 and CP 2000 communications processors to connect multiple, independent, 
compatible computer systems into a network for distributed processing and resource 
sharing. 

BNA Version 1 

The original version of BNA, which uses data link processors (DLPs) within the host 
and supports communications between Unisys A Series, B 1000 Series, V Series, and 
CP9500 systems. 

BNA Version 2 

A second-generation version of BNA, which uses communications processors such as 
the CP 2000 for enhanced performance, provides facilities for centralized network 
administration, and supports multiple types of industry-standard and proprietary 
networks. 

C 

CANDE 

See Command and Edit. 
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central processing module (CPM) 

The central processor for data processing on host data unit (HDU) and resource 
management module (RMM) systems. 

central processing unit (CPU) 

The computer hardware unit that controls and executes the instructions contained in 
object code files. 

COBOL 

Common Business-Oriented Language. A widely used, procedure-oriented language 
intended for use in solving problems in business data processing. The main 
characteristics of COBOL are the easy readability of programs and a considerable 
degree of machine independence. COBOL is the most widely used procedure-oriented 
language. 

COBOL74 

A version of the COBOL language that is compatible with the American National 
Standard X3.23-1974. 

Command and Edit (CANDE) 

A time-sharing message control system (MCS) that enables a user to create and edit 
files, and to develop, test, and execute programs, interactively. 

control (CTL) 

The hardware that provides control functions for a peripheral device or string of 
peripherals. Control (CTL) is a preferred synonym for data link processor (DLP) on 
resource management module (RMM) systems. 

copy descriptor 

A duplicate of a mom descriptor except the copy bit is set to 1. A copy descriptor is 
derived from a mom descriptor and multiple copy descriptors can reference the same 
data segment. 



CPM 
CPU 
CSC 
CTL 



See central processing module. 
See central processing unit. 
See customer service center. 
See control. 



customer service center 

A subsidiary-level Unisys support office that provides secondary support to customer 
service personnel. 
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D 

data communications controller (DCC) 

The subset of the master control program (MCP) operating as a group of 
independent tasks, each associated with one network support processor (NSP) or data 
communications data link processor (DCDLP). 

Data Link Control (BDLC) 

The bit-synchronous transmission mode used on Unisys A Series systems. BDLC 
is compatible with the international standard high-level data link control (HDLC) 
protocol. 

data link processor (DLP) 

A processor that serves as the system interface to a specific peripheral device, 
controller, or communications network. 

Data Management System II (DMSII) 

A specialized system software package used to describe a database and maintain the 
relationships among the data elements in the database. 

data terminal equipment (DTE) 

The functional unit of a data station that establishes, maintains, and releases a 
connection and provides code and signal conversion between the data station and the 
transmission line. A DTE can serve as a data source, a data sink, or both and can 
provide for the data communications control functions to be performed in accordance 
with link protocol. Packet-mode DTEs divide the data into packets. Non-packet-mode 
DTEs require packet assemblers/disassemblers (PADs) to operate in an X.25 MCS 
environment. 

data transfer unit (DTU) 

A hardware unit used on an A 16 or A 17 system that provides support for the disk 
cache feature by transferring data between disk cache pages in memory and the user 
data buffers. 

DCC 

See data communications controller. 

disk resource control (DRC) system 

An optional feature of the disk subsystem that provides the ability to control disk 
space on a per user basis. The DRC system does not support interchange (IC) packs 
or installation-allocated disk (IAD) usage. DRC is not a security system, but normal 
security checking occurs. 

distributed systems service (DSS) 

One of a collection of services provided on Unisys hosts to support communications 
across multihost networks. DSSs can be services such as file handling, station transfer, 
and mail transfer. 

DLP 

See data link processor. 
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DMSII 

See Data Management System II. 

DRC 

See disk resource control system. 

DSS 

See distributed systems service. 

DTE 

See data terminal equipment. 

DTU 

See data transfer unit. 

E 

EMS 

See Entry and Medium Systems. 

end of job (EOJ) 

The termination of processing of a job. 

Entry and Medium Systems (EMS) 

A designation referring to the Micro A and A 1 through A 10 systems. 

EOJ 

See end of job. 

F 

family name 

The name, consisting of up to 17 alphanumeric characters, assigned by an installation 
to identify a family of disks. 

FIB 

See file information block. 

file information block (FIB) 

A data structure in an object code file that contains information describing a file. 

file name 

A unique identifier for a file, consisting of name constants separated by slashes. Each 
name constant consists of letters, digits, and selected special characters. A file name 
can be optionally preceded by an asterisk (*) or usercode, and optionally followed by 
ON and a family name. 

file title 

The complete identifier for a file that consists of the file name, the word ON, and the 
family name. 
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File Transfer, Access, and Management (FTAM) 

The standard developed by the International Standards Organization (ISO) for file 
exchange and management across an Open Systems Interconnection (OSI) network. 
FTAM systems can access file attributes (for example, password information) and the 
contents of files (including individual records, as well as entire files). See also OSI File 
Transfer, Access, and Management. 

FORTRAN 

Formula Translation. A high-level, structured programming language intended 
primarily for scientific use. 

FTAM 

See File Transfer, Access, and Management. 

H 

halt/load 

A system-initialization procedure that temporarily halts the system and loads the 
master control program (MCP) from a disk to main memory. 

HDU 

See host data unit. 

host data unit (HDU) 

The A 12 and A 15 system host interface to the I/O subsystem. An HDU is configured 
with up to three host-dependent ports (HDPs), each of which supports two message 
level interface (MLI) cables. 

I 

I/O 

Input/output. An operation in which the system reads data from or writes data to a file 
on a peripheral device such as a disk drive. 

I/O control block (IOCB) 

A data structure used for communication between the host system and the I/O 
subsystem. 

I/O module (IOM) 

A functional module for connecting a system to a peripheral device. The I/O module is 
the interface between the processor memory and the I/O subsystem. 

I/O processor (IOP) 

A specialized processor for moving data between system memory and the I/O 
subsystem. 

InfoGuard 

The Unisys security-enhancement software for A Series systems. InfoGuard provides 
such features as password management, selective logging and auditing, tape volume 
security, and simplified system-security configuration. 
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initialization, verification, relocation (IVR) 

A maintenance procedure used to write sector boundaries and a blank label on a disk. 
You can use the IVR procedure to make a new disk pack usable by the system or to 
make a damaged disk reusable by eliminating defective sectors. The end product of an 
IVR procedure is a master available table (MAT) of available disk segments with all old 
files on the disk erased. 

intelligent peripheral interface (IPI) 

An industry-recognized standard for the specification of the interface between a 
computer and a peripheral device. 

IOCB 

See I/O control block. 

IOM 

See I/O module. 

IOP 

See I/O processor. 

IPI 

See intelligent peripheral interface. 

IVR 

See initialization, verification, relocation. 

J 

job 

An independent process. The job of a particular task is the independent process that is 
the eldest ancestor of that task. 

L 

label 

(1) The first 28 sectors on a disk, on which information about the disk is stored. This 
information includes the family name and serial number, the master available table 
(MAT), the family index number, information about the family base pack, and a pointer 
to the system directory if the disk contains a directory. (2) An area on a magnetic tape 
(MT) that contains permanent attributes associated with the tape volume or with 
individual files on the volume, such as the volume serial number and the file name. 

line support processor (LSP) 

The data communications subsystem processor that manages communication with the 
host and initiates processes that control the input of messages to and the output of 
messages from data communications lines. 

LSP 

See line support processor. 



Glossary-6 



8600 0478-100 



Glossary 



M 

MARC 

See Menu-Assisted Resource Control. 

mark stack control word (MSCW) 

A special control word used by the central processor unit (CPU) to define environments 
and stacks. The MSCW is generated when compilers issue the mark stack (MKST) 
command to call subroutines or procedures. 

master available table (MAT) 

A table stored on each disk that lists the valid sectors on the disk that were successfully 
processed by the initialization, verification, relocation (IVR) procedure. Pointers to 
defective sectors are deleted from the MAT so that these sectors cannot be accessed. 
Normally, the MAT shows the entire disk as being available, minus any defective 
sectors. 

master control program (MCP) 

The central program of the A Series operating system. The term applies to any master 
control program that Unisys might release for A Series systems. 

Master Control Program/Advanced Systems (MCP/AS) 

The version of the master control program (MCP) that supports the Actual Segment 
Descriptor (ASD) memory architecture. As of the Mark 3.9 release, MCP/AS is the only 
master control program available on A Series. 

MAT 

See master available table. 

MCP 

See master control program. 

MCP/AS 

See Master Control Program/Advanced Systems. 

MCS 

See message control system. 

memory interface unit (MIU) 

A device that enables a user to interface with memory. 

memory storage unit (MSU) 

The smallest unit of memory that can be readied or saved on an A Series system. An 
MSU contains 1 million to 4 million words, depending on the type of MSU. MSU types 
cannot be mixed on a system. 

Menu-Assisted Resource Control (MARC) 

A menu-driven interface to A Series systems that also enables direct entry of 
commands. 
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message control system (MCS) 

A program that controls the flow of messages between terminals, application programs, 
and the operating system. MCS functions can include message routing, access control, 
audit and recovery, system management, and message formatting. 

Message Handling System (MHS) 

A distributed systems service (DSS) that implements the Consultative Committee 
on International Telegraphy and Telephony (CCITT) X.400 standards for 
store-and-forward message handling systems. 

message level interface (MLI) 

The interface between the host system, the I/O subsystem, and the data 
communications subsystem. 

message level interface processor (MLIP) 

See I/O processor, Entry and Medium Systems. 

MHS 

See Message Handling System. 

MIU 

See memory interface unit. 

MLI 

See message level interface. 

MLIP 

An acronym for the obsolete term message level interface processor; see I/O processor, 
Entry and Medium Systems. 

mom descriptor 

The original descriptor for a data segment. For a given data segment in memory, there 
is one mom descriptor, but there can be many copy descriptors. A mom descriptor is a 
data descriptor that has 0 (zero) in the copy bit. 

MSCW 

See mark stack control word. 

MSU 

See memory storage unit. 

N 

network-independent software (NIS) 

System software that supports network administration functions common to most 
types of multihost data communications networks. These functions include network 
selection, initiation, termination, and command processing. 

network information file II (NIFII) 

The file generated when a Network Definition Language II (NDLII) program is 
compiled. This file contains line support processor (LSP) and network support 
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processor (NSP) code, data structures, and other information. A NIFII is also generally 
referred to as a network information file (NIF). 

network support processor (NSP) 

A data communications subsystem processor that controls the interface between a 
host system and the data communications peripherals. The NSP executes the code 
generated by the Network Definition Language II (NDLII) compiler for line control 
and editor procedures. An NSP can also control line support processors (LSPs). 

NIFII 

See network information file II. 

NIS 

See network-independent software. 

NSP 

See network support processor. 



0 

ODT 

See operator display terminal. 

op-code 

An instruction that is executable by the machine. Op-codes are either created by a 
compiler and stored in an object code file or created at run time by an interpreter. 

Open Systems Interconnection (OSI) 

A set of data communications standards defined by the International Organization 
for Standardization (ISO) that provide for communications between different types of 
computer systems. The application services defined under OSI include File Transfer, 
Access, and Management (FTAM) and the Message Handling System (MHS). 

operator display terminal (ODT) 

A terminal or other device that is connected to the system in such a way that it can 
communicate directly with the operating system. The ODT allows operations personnel 
to accomplish system operations functions through either of two operating modes: 
system command mode or data comm mode. 

OSI 

See Open Systems Interconnection. 

OSI File Transfer, Access, and Management (OSI FTAM) 

An A Series distributed systems service (DSS) that supports Open Systems 
Interconnection (OSI) standards for file management functions such as reading, 
writing, and copying files on remote hosts. 

OSI FTAM 

See OSI File Transfer, Access, and Management. 
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P 

PCD 



See peripheral configuration diagram. 



peripheral 

A device used for input, output, or file storage. Examples are magnetic tape drives, disk 
drives, printers, or operator display terminals (ODTs). 

peripheral configuration diagram (PCD) 

A list of units on a system, coupled with a diagram that shows how the units are 
connected to the system. 

peripheral test driver (PTD) 

A module of the master control program (MCP) that executes maintenance tests for 
peripheral devices. 



PIB 



PL/I 



process 



See process information block. 



Programming Language I. A high-level, structured programming language designed 
primarily for scientific and commercial use. 



The execution of a program or of a procedure that was initiated. The process has its 
own process stack and process information block (PIB). It also has a code segment 
dictionary, which can be shared with other processes that are executions of the same 
program or procedure. 

process information block (PIB) 

A memory structure that is associated with each process stack and code segment 
dictionary. The PIB contains control information that is visible only to the operating 
system. The PIB for a process stack also contains a reference to a task attribute block 
(TAB). 

programmable read-only memory (PROM) 

A type of memory that can be modified once for specific purposes, and then can only be 
read. 

PROM 

See programmable read-only memory. 

PTD 

See peripheral test driver. 



R 

RAM 

See random-access memory. 
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random-access memory (RAM) 

A type of memory that allows the reading and writing of a memory cell without regard 
to the location of the preceding read or write operation on the memory. An important 
characteristic of RAM is that it is volatile; that is, the data stored in it remains there 
only as long as the computer is not turned off or rebooted. 

remote supervisory console (RSC) 

A terminal released to remote job entry (RJE) that provides a remote operator and 
system interface through input and output messages. 

remote support center (RSC) 

A facility such as a customer service center that provides remote diagnostic capability 
for hardware and software problems. 

resource management module (RMM) 

A hardware module that interfaces with the I/O subsystem and schedules tasks on the 
E-mode processor (EMP) by way of a message protocol. 

RMM 

See resource management module. 

RSC 

See remote supervisory console, remote support center. 

S 

s-code file 

In the peripheral test driver (PTD), a file storing semicompiled instructions called 
s-ops. 

s-op 

In the peripheral test driver (PTD), a semicompiled instruction that cannot be directly 
executed by the machine. S-ops are stored in s-code files and are translated into 
op-codes at run time by the PTD interpreter. 

SCSI 

See small-computer system interface. 

SCSI maintenance bus (SMB) 

Proprietary SCSI protocol used to communicate between the maintenance processor 
and the mainframe hardware. 

SCX 

See system console transport. 

small-computer system interface (SCSI) 

An interface adopted by the computer industry as a standard that allows the connection 
of low-cost peripherals to computer systems. 

SMB 

See SCSI maintenance bus. 
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stability log 

A file on A 12, A 15, A 16, and A 17 systems that is dedicated solely to storing stability 
information about the system, such as processing interruptions, halt/loads, and other 
software or hardware problems encountered during daily processing. The stability log 
is separate from the system summary log (SUMLOG). 

system console transport (SCX) 

On the A 11, A 16, and A 19 systems, a device that enables the operating system, in 
cooperation with the system console, to send the stability log from an A series machine 
to the Unisys remote support center by means of an automatic transport service. 

T 

TAB 

See task attribute block. 

task 

(1) A dependent process. (2) Any process, whether dependent or independent. See also 
process. 

task attribute block (TAB) 

A memory structure that stores the values of task attributes associated with a given 
task variable. Before the Mark 3.9 release, this information was part of the process 
information block (PIB). 

task control processor (TCP) 

A special purpose processor that schedules tasks on the E-mode processor (EMP) by 
way of a message protocol. 

tasking program 

A program that has been marked with tasking status by the MP (Mark Program) 
system command. 

tasking status 

A type of security status that permits a program to perform most of the actions that 
normally require message control system (MCS) privileges. A process receives tasking 
status if it is running without a usercode and is executing code from a tasking program. 

TCP 

See task control processor. 

U 

usercode 

An identification code used to establish user identity and control security, and to 
provide for segregation of files. Usercodes can be applied to every task, job, session, and 
file on the system. A valid usercode is identified by an entry in the USERDATAFILE. 
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w 

WFL 

See Work Flow Language. 

Work Flow Language (WFL) 

A Unisys language used for constructing jobs that compile or run programs on A Series 
systems. WFL includes variables, expressions, and flow-of-control statements that offer 
the programmer a wide range of capabilities with regard to task control. 
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< absolute address >, 4-10 

ACCEPT: WRONG CODE FILE - OK OR 

RESTART error message, 4-141 
ACCESSCODE data item 

LOGGER, 8-36, 8-39, 8-41 
ACCOUNTING (Resource Accounting) 

system command, 12-4 
ACLOSE directive 

peripheral test driver (PTD), 9-8 

< active spec>, 4r-61 

< adapter number >, 3-5 

< additional selection options >, 7-17 

< address > 

CAND command, 4-28 

DUMPANALYZER, 4-99 
AIIO directive 

peripheral test driver (PTD), 9-8 
ALL directive 

peripheral test driver (PTD), 9-9 
ALLPORTS command 

DUMPANALYZER, 4-18 
anonymous task and file accounting, 12-3 
AOPEN directive 

peripheral test driver (PTD), 9-8 
AREAS command 

DUMPANALYZER, 4-18 
AREASIZE data item 

LOGGER, 8-39 
ARRAYLIMIT command 

DUMPANALYZER, 4-24 
<ASD number>, 4-11 
ASDNUMBER command 

DUMPANALYZER, 4-24 
ASDTABLEBASE command 

DUMPANALYZER, 4-26 
ASSOCIATION data item 

LOGGER, 8-39 

< attribute name>, 4-11 
AVGCORECODE data item 

LOGGER, 8-36 
AVGCOREDATA data item 



LOGGER, 8-36 
AX (Accept) Message command 

and the DUMPANALYZER 10 command, 
4-61 



B 

< backspace count > 

DCAUDITOR, 2-2 
BAD DATA RECOVERY IN RECORD <#> 

error message, 4-141 
BAD DUMPANALYZER INPUT CARDS 

error message, 4-141 
BAD MCP STACK POINTER error message, 

4-141 

BAD PAB error message, in 

DUMPANALYZER, 4-99 
BAD PABNO error message, in 

DUMPANALYZER, 4-99 

BARS 

commands 

BYE, 1-2 

CYCLE, 1-2 

DISPLAY, 1-3 

HELI* 1-3 

LOAD, 1-3 

NEWDISPLAY, 1-4 

PACK, 1-5 

PERIOD, 1-5 

SAVE, 1-5 

TEACH, 1-3 

WORDS, 1-6 
displaying the default screen, 1-1 
introduction, 1-1 
keywords, 1-6 
MONITOR file, 1-7 
BCLOSE directive 

peripheral test driver (PTD), 9-8 
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BDLC, (See data link control (BDLC)) 
BIIO directive 

peripheral test driver (PTD), 9-8 
billing applications 

and REPORTLOGENTRIES procedure, 
10-1 

<bit count>, 4-16 
BLOCKSIZE data item 

LOGGER, 8-39 
BNA Version 1 

SUMLOG, 12-223 
BNA Version 2 

SUMLOG, 12-277 
BNAV2TRANSLATION system library, 7-1 
BOJ directive 

peripheral test driver (PTD), 9-8 
BOPEN directive 

peripheral test driver (PTD), 9-8 
<BOXINFO cell name>, 4-26 
BOXINFO command 

DUMPANALYZER, 4-26 
BREAK command 

LOGGER, 8-10 
< break options >, 8-10 
BUFFERSIZE data item 

LOGGER, 8-39 
BUFFSOURCE data item 

LOGGER, 8-39 
BYE command 

BARS, 1-2 

DUMPANALYZER, 4-28 



c 

CAND command 

DUMPANALYZER, 4-28 
CANDE DCSTATUS command 

DCSTATUS, 3-1 
CANNOT ANALYZE - USE PREVIOUS 
DUMP ANALYZER 

error message, 4-142 
CANNOT ANALYZE - MCP 

INCOMPATIBLE WITH 
DUMPANALYZER 

error message, 4-142 
CARD file 

LOGGER, 8-52 
CARDSPUNCHED data item 

LOGGER, 8-36 
CARDSREAD data item 

LOGGER, 8-36 



CB command 

DUMPANALYZER, 4-28 
CCSVERSION data item 

LOGGER, 8-39 
CHARGECODE data item 

LOGGER, 8-36, 8-39, 8-41 
CHARGES data item 

LOGGER, 8-36, 8-39, 8-41 
CLOSETYPE data item 

LOGGER, 8-39 
<code file name>, 4-75 
<code identifier >, 7-17 
CODEFILE command 

DUMPANALYZER, 4-30 

effect on family substitution, 4^-4 
CODEFILE data item 

LOGGER, 8-36 

< concatenation >, 4-16 
<configuration and maintenance options> , 

7-7 

COREMAP command 

DUMPANALYZER, 4-31 
CORRECTION command 

LOGGER, 8-4 

< count >, 9-5 

CREATIONDATE data item 

LOGGER, 8-39 
CS (Change Supervisor) system command 

use with HARDCOPY and PRINTCOPY, 
5-2 

CSC, (See customer service center (CSC)) 

< current date > , 7-5 

customer service center (CSC), 13-1 
CYCLE command 
BARS, 1-2 



D 

DA (Dump Analyzer) system command, 4—7 

<data comm options>, 7-11 

data communications controller (DCC), 3-5 

data link control (BDLC), 12-257 

data link processor (DLP) 

abbreviations of types, 7-24 
DATE data item 

LOGGER, 8-36, 8-38 
<date>, 7-3, 12-1 
DC command 

DUMPANALYZER, 4-32 
<DC file prefix>, 3-5 
DCALGOL 
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and STATUSCHANGEREQUEST 

procedure, 11-2 
and the REP ORTLOGENTRIES 
procedure, 10-1 
DCAUDITOR, 2-1 

ID (Initialize Data Comm) system 

command, 2-1 
NSPAUDIT file, 2-1 
options 

DCCONTROL, 2-2 
DCINITIAL, 2-2 
LINES, 2-2 
LSNS, 2-2 
STATIONS, 2-2 
sample report, 2-3 
DCC, (See data communications controller 

(DCC)) 
DCINITIAL option 

DCAUDITOR, 2-2 
DCSTATUS, 3-1 
commands 

CANDE DCSTATUS, 3-1 
DIAGNOSTICMCS DI^ 3-2 
execution, 3-1 

inactive DATACOMINFO file options, 3^4 
options 
ALL, 3-5 
FILE, 3-6 
GRAPH, 3-5 
LSI* 3-5 
NETWORK, 3-6 
NSI>3-5 
STATION, 3-5 
TABLES, 3-5 
TERMINAL, 3-5 
running the program, 3-3 
<dcstatus option list>, 3-4 

use of, 3-1 
<dcstatus option >, 3-2 
DEADLOCK command 

DUMPANALYZER, 4-37 
DEBUG command 

DUMPANALYZER, 4-38 
DEBUG option 

LOGGER, 8-5 
< decimal number >, 4-10 
DECODEEXTRD option, in 

LOGANALYZER, 7-10 
DEFAULT option 

DISPLAY command, 1-3 
LOAD command, 1-3 
DENSITY data item 



LOGGER, a-39 
DEPTASKACCOUNTING task attribute, 
12-4 

DESCANAL command 

DUMPANALYZER, 4-39 
DESTMCS data item 

LOGGER, 8-36 
DESTUNIT data item 

LOGGER, 8-36 
DETAIL 

COREMAP command, 4-31 
device mnemonic definitions, 7-9 

< device option > , 7-8 
DIAGNOSTICMCS DP command 

DCSTATUS, 3-2 
diagnostics entry, in SUMLOG, 12-294 

< diagnostics options > in LOGANALYZER, 

7-13 

DIR, (See Open System Interconnection 

(OSI) Directory) 
DIR option in LOGANALYZER, 7-14 
<DIRsubtypes> in LOGANALYZER, 7-14 
directives 

peripheral test driver (PTD), 9-4 
DISK data item 

LOGGER, 8-38 
disk resource control (DRC) system 
LOGGER reporting 
DRCONLY, 8-5 
example, 8-34 
RESETDRC, 8-6 
WRITEDRCDATA, 8-5 
DISKFILE command 

DUMPANALYZER, 4-41 
DISKINUSE data item 

LOGGER, 8-41 
DISPLAY command 

BARS, 1-3 
DISPLAY directive 

peripheral test driver (PTD), 9-5 
DISPLAY: BAD DATA RECOVERY IN 
RECORD <#> error message, 
4^141 

DISPLAY: BAD DUMPANALYZER INPUT 
CARDS error message, 4-141 

DISPLAY: BAD MCP STACK POINTER 
error message, 4-141 

DISPLAY: CANNOT ANALYZE - USE 
PREVIOUS DUMP ANALYZER 
error message, 4-142 
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DISPLAY: DUMP TAPE HAS BAD 

INFORMATION IN RECORD 
message, 4-141 
DISPLAY: ERROR UNABLE TO 
GENERATE GLOBAL 
IDENTIFIERS error, 4H42 
DISPLAY: SAVE ABORTED FOR DIRECT 

I/O ERROR error message, 4^142 
DISPLAY: SAVE ABORTED FOR 

INSUFFICIENT DISK SPACE 
message, 4-142 
DISPOSITION data item 

LOGGER, 8-40 
distributed systems service (DSS) 
inLOGANALYZER, 7-14 
inSUMLOG, 12-294 
DL (Disk Location) system command 
and log releases, 12-1 
LOGANALYZER, 7-5 
LOGGER, 8-42 
DLI? (See data link processor (DLP)) 
DPAOUTPUT job printouts, 4-109 
DR (Date Reset) system command, 12-11 
DRC system, (See disk resource control 

(DRC) system) 
DRCAUDIT file 

LOGGER, 8-52 
DRCDATA file 

file data items, 8-41 
LOGGER, 8-52 
DSS, (See distributed systems service 
(DSS)) 

DSS option in LOGANALYZER, 7-14 
<DSS subtypes> in LOGANALYZER, 7-14 
DUMMYFILE data item 

LOGGER, 8-40 
DUMP directive 

peripheral test driver (PTD), 9-5 
DUMP TAPE HAS BAD INFORMATION 
IN RECORD error message, 4^141 
DUMPANALYZER, 4-1 
commands 

ALLPORTS, 4-18 

AREAS, 4-18 

ARRAYLIMIT, 4-24 

ASDNUMBER, 4-24 

ASDTABLEBASE, 4-26 

BOXINFO, 4-26 

BYE, 4-28 

CAND, 4-28 

CB, 4-28 

CODEFILE, 4-30 
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COREMAI? 4-31 
DC, 4-32 

DEADLOCK, 4-37 
DEBUG, 4-38 
DES CANAL, 4-39 
DISKFILE, 4-41 
FIB, 4-41 
FINDIOCB, 4^44 
FINDSTACKS, 4-45 
GC,4U46 
GRAPHS, 4-48 
HARDINFO,4-48 
HDR, 4-50 
HEADING, 4-52 
HEAR 4-53 
HEAPSTACK, 4^58 
HELI> 4-60 
10,4^60 
IOCB, 4-66 
IOTABLE, 4-68 
KEEI* 4-68 
LIB, 4-69 
LOADXREF, 4-75 
LOCKS, 4-76 
MASK, 4-78 
MD, 4-80 
MEM, 4-81 
MESSAGES, 4-81 
MIX, 4-82 
MODE, 4-83 
MSCW, 4-86 
NAMES, 4-87 
NSI> 4^89 
OLAYINFO, 4^91 
OPT, 4-91 
PATTERN, 4-95 
PC, 4^96 
PIB, 4^97 
PORT, 4-99 
PRINTARRAY, 4-100 
PRINTCODE, 4-96 
PRINTER, 4-101 
PRINTVAL, 4-102 
PROCS, 4^102 
PROCSTACKS, 4-102 
PROGRAMDUMS 4-102 
Py 4-104 
QUEUE, 4-106 
RECESS, 4-108 
RELEASE, 4-108 
RELX, 4-109 
REMOTE, 4H09 



8600 0478-110 



Index 



REPEAT, 4-109 

RESULTQ, 4-110 

SAVE, 4-112 

SEARCH, 4-112 

STACK, 4-116 

STACKWINDO^ 4-123 

STOP 4-124 

SUBPORT, 4-125 

SUMMARY, 4-127 

TRACE, 4-138 

USE, 4-140 

WHERE, 4-140 

WHO, 4-141 
error messages, 4-141 
files 

MCPCODEFILE, 4-3 

OPTIONS, 4-2 

pseudorecovery, 4-3 

TAPEIN,4-2 
MCP level compatibility, 4-4 
memory dumps 

saved, 4-4 
program dumps 

analyzing, 4-9 
running the program, 4—5 
TAB, 4-131 
TCPINFO, 4-134 
TERMINAL, 4-136 
<dumpanalyzer command >, 4-60 
DUMPEXTRD option, in LOGANALYZER, 
7-10 



E 

ELAPSEDTIME data item 

LOGGER, 8-36 
END command 

LOGGER, 8-11 
EOJ directive 

. peripheral test driver (PTD), 9-9 
ERROR directive 

peripheral test driver (PTD), 9-6 
ERROR UNABLE TO GENERATE 

GLOBAL IDENTIFIERS error 
message, 4-142 
ERROR: SCANNING TCP message, in 

DUMPANALYZER, 4-129 
EXCLUDE command 

LOGGER, 8-11 
extended time period report 
from a SUMLOG file, 8-42 



EXTMODE data item 

LOGGER, 8-40 
EXTNAME data item 

LOGGER, 8-40 
EXTRA parameter, of REPORT_ 
LOG ENTRIES procedure, 
10-2 



F 

FA (File Attribute) command, 4-5 

< family name > , 3-2 
FAMILYNAME data item 

LOGGER, 8-40 
FASUMMARY ONLY ALLOWED ON A17 

SUMLOGS error message, 7-7 
FIB, (See file information block (FIB)) 
FIB command 

DUMPANALYZER, 4-41 
file equating 

LOGGER, 8-47 
file information block (FIB), 4-3 
<file name> 

DISPLAY command, 1-3 

LOAD command, 1-3 
<filetitle>, 4-112 

FILEACCOUNTING task attribute, 12-4 
FILEIODATA file 

file data items, 8-39 

LOGGER, 8-2, 8-52 
FILEKIND data item 

LOGGER, 8-40 
FILESTRUCTURE data item 

LOGGER, 8-40 
FINDIOCB 

DUMPANALYZER, 4-44 
FINDSTACKS command 

DUMPANALYZER, 4-45 

< first parameter >, 4-116 
FRAMESIZE data item 

LOGGER, 8-40 



G 

GC command 

DUMPANALYZER, 4-46 
<global ID>,4-11 

DUMPANALYZER simple address, 4-10 

WHERE command, 4-140 
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< global procedure name>, 4-45 
GO directive 

peripheral test driver (PTD), 9-7 
GRAPHS command 

DUMPANALYZER, 4-48 
GS (group-separator character), 9-2 

H 

halt/loads 

and backup MCP unit information, 
12-146 

RSVP messages after, 13-3 
HARDINFO command 

DUMPANALYZER, 4-48 
hardware control block (HCB), 4-66 
HCB, (See hardware control block (HCB)) 
HDR command 

DUMPANALYZER, 4-50 
HDU, (See host data unit (HDU)) 
HEADING command 

DUMPANALYZER, 4-52 

LOGGER, 8-13 
HEAP command 

DUMPANALYZER, 4-53 
heaps 

analyzing in DUMPANALYZER, 4-53 
HEAPSTACK command 

DUMPANALYZER, 4-58 
HELP command 

BARS, 1-3 

DUMPANALYZER, 4-60 
HELP IODEBUG directive 

peripheral test driver (PTD), 9-8 
HELP option 

COREMAP command, 4-31 

< hexadecimal address >, 4-15 

< hexadecimal number >, 4-10 

< hexadecimal stack number >, 4-10 

HI (Cause EXCEPTIONEVENT) command 
use with HARDCOPY and PRINTCOPY, 
5-1 

HISTO 

COREMAP command, 4-31 
HL data item 

LOGGER, 8-38 
HLCN, (See Host LAN Connection (HLCN)) 
HLCN option in LOGANALYZER, 7-14 
<HLCN subtypes> in LOGANALYZER, 
7-14 



HLUNIT (Specify Halt/Load Unit) system 

command, 13-2 
host data unit (HDU), 3-1 
Host LAN Connection (HLCN) 

in LOGANALYZER, 7-14 

inSUMLOG, 12-294 
HWERRORSUPPORT system library, 7-1 



I 

I/O control block (IOCB), 4-66 
I/O processor (IOP), 3-1 
ID (Initialize Data Comm) system command, 
2-1 

<in spec>, 8-3 
INCLUDE command 
LOGGER, 8-13 

< index > 

CAND command, 4-28 
SUBPORT command, 4-125 
INFO parameter to REPORT_ 

LOG ENTRIES procedure, 
10-2 
InfoGuard 

and REPORT_LOG_ENTRIES procedure, 
10-4 

INITPBITS data item 

LOGGER, 8-36 
INITPBITTIME data item 

LOGGER, 8-36 

< input records >, 8-3 
input-specification commands 

LOGGER, 8-4 

< integer- 1>, 2-1 
<integer-2>, 2-1 
< integer > 

CYCLE command, 1-2 
DCAUDITOR, 2-1 
HARDCOPY and PRINTCOPY, 5-3 
LOGANALYZER, 7-16 
PERIOD command, 1-5 
STACK command, 4-116 
SUMMARY command, 4-127 
intercom queues 

and REPORT LOG ENTRIES procedure, 
10-4 

and STATUS CHANGE REQUEST 
procedure, 11-3 
internationalization 

logging, 12-278 
interrupt strategies 
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IDLE, 6-2 

IOFINISH, 6-2 

QEMPTY, 6-2 

WAITING, 6-2 
INTERVAL parameter, 6-2 
INTMODE data item 

LOGGER, 8-40 
INTNAME data item 

LOGGER, 8-40 
INVALID SABNO error message, in 

DUMPANALYZER, 4^125 
10 command 

DUMPANALYZER, 4-60 
IOCB, (See I/O control block (IOCB)) 
IOCB command 

DUMPANALYZER, 4-66 
IODEBUG directive 

peripheral test driver (PTD), 9-9 
IOENTERRUPT parameter, 6-2 
IOF, (See I/O processor (IOP)) 
<IOP number>, 4-68 
IOSTOP directive 

peripheral test driver (PTD), 9-9 
IOTABLE command 

DUMPANALYZER, 4-68 
IOTIME data item 

LOGGER, 8-36, 8-40 
IOTRACE directive 

peripheral test driver (PTD), 9-5 
ISTUTILITY, 13-4 

canceling current screen, 13-7 

Collected Halt Status screen, 13-9 

Collection Configuration screen, 13-14 

configuring halt review criteria, 13-14 

Daily Comment screen, 13-13 

entering daily comments, 13-13 

exiting program, 13-7 

Halt Evaluations screen, 13-10 

Halt Selection Items screen, 13-9 

initiating, 13-6 

installing, 13-4 

Main Menu screen, 13-7 

refreshing screen, 13-7 

returning to previous screen, 13-7 

reviewing halt data, 13-8 

Summary Data screen, 13-12 

transfer schedule feature 
installing, 13-4 
scheduling transfers, 13-14 

using online help, 13-7 

using screens, 13-6 

viewing internal failure summaries, 13-11 



<item> 

BREAK command, 8-10 
EXCLUDE command, 8-11 
INCLUDE command, 8-13 
OUTPUT command, 8-14 
SORT command, 8-16 



J 

<job/task/session options >, 7-16 
JOBENTRYTIME data item 

LOGGER, 8-36 
JOBFORMATTER 

customizing log analysis, 12-7 

issuingjob summaries, 12-7 
JOBNO data item 

LOGGER, 8-36, 8-40 
JOBQUEUEDTIME data item 

LOGGER, 8-36 
JOBS data item 

LOGGER, 8-38 
JOBSUMMARYfile 

correcting CHARGES field, 8-47 

file data items, 8-36 

LOGGER, 8-2, 8-52 



K 

KEEP command 

DUMPANALYZER, 4-68 
keywords 

BARS, 1-6 
KIND data item 

LOGGER, 8-40 



L 

LAYOUT 

COREMAP command, 4-31 
LC (Log Comment) system command, 7-18 
<left bit from>, 4-16 
<leftbitto>, 4^16 
<lexlevel>, 4-96 

LG (Log for Mix Number) system command, 

12-3 
LIB command 

DUMPANALYZER, 4-69 
line support processor (LSP), 3-5 
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LINES data item 
LOGGER, 8-36 
LINES directive 

peripheral test driver (PTD), 9-9 
LINES option 

DCAUDITOR, 2-2 
link descriptions for hardware configuration 
log entries 
A 16 systems, 12-126 
A 17 systems, 12-117 
EMS systems, 12-105 
HDU systems, 12-110 
LINK words, in SUMLOG, 12-11 

layout of, 12-12 
LJ (Log to Job) system command, 7-18 
LOAD command 

BARS, 1-3 
LOADXREF command 

DUMPANALYZER, 4-75 
localization 

logging, 12-278 
LOCKS command 

DUMPANALYZER, 4-76 
LOCS file, 4-75 
log entries, 12-1 

general format, 12-9 
major and minor types, 12-26 
LOG file 

LOGGER, 8-52 
log releases, 12-1 
log structure, 12-8 
LOGANALYZER 

analyzing logs from different releases, 7-2 
configuration and maintenance options 
CONFIG, 7-7 
CPUERROR, 7-7 
DECODEEXTRD, 7-10 
< device option >, 7-8 
DUMPEXTRD, 7-10 
HL, 7-7 
IOERROR, 7-8 
IOSUMMARY, 7-7 
MAINFRAME, 7-7 
MAINT, 7-8 
data comm options 
BNA, 7-11 
BNAV2, 7-11 
COMS, 7-11 
HLCN, 7-11 
IDC, 7-11 
MCS, 7-11 
NMS, 7-12 



NSI> 7-12 

SNA, 7-12 

TCP/II> 7-13 
diagnostics options 

DIR, 7-14 

DSS, 7-14 

HLCN, 7-14 

MHS, 7-14 

NIS, 7-14 

NMS, 7-14 

OSI, 7-14 

SNA, 7-14 

TCPIIJ 7-14 
how to initiate, 7-2 

HYPERchannel with DECODEEXTRD, 

7-9, 7-10 
installing support libraries, 7-1 
job/task/session options 

ABORT, 7-16 

BOJ, 7-16 

BOT, 7-16 

DMS, 7-16 

EOJ, 7-16 

EOT, 7-16 

ERRORS, 7-16 

FILE, 7-16 

IDENTITY, 7-16A 

IO, 7-16 

JOB, 7-16B 

LIB, 7-16B 

MIX, 7-16B 

PRINTS, 7-16C 

SESSION, 7-16C 

TASK, 7-16C 
missing log entries, 7-2 
option list, 7-3 
options, 7-6 
output options 

APPEND, 7-21 

CREATE, 7-22 

DUMI? 7-22 

<sort option >, 7-22 

SORTED, 7-22 

SORTSIZE, 7-22 

UNSORTED, 7-22 
selection options 

ACCESSCODE, 7-18 

ALL, 7-6 

CHARGECODE, 7-18 
COMMENT, 7-18 
DATE, 7-6 

DEIMPLEMENTATION, 7-18 
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DRC, 7-18 

MSG, 7-19 

OPERATOR, 7-19 

RA\^ 7-6 

RESULT, 7-20 

SECURITY, 7-20 

UNKNOWN, 7-20 

USERCODE, 7-20 

USERDATA, 7-21 

VOLUMES, 7-21 
LOGGER 

calculating charges, 8-46 
capabilities, 8-2 
commands 

BREAK, 8-10 

CORRECTION, 8-4 

END, 8-11 

EXCLUDE, 8-11 

HEADING, 8-13 

INCLUDE, 8-13 

MAXRECORDS, 8-5 

OPTION, 8-5 

OUTPUT, 8-14 

PAGE SIZE, 8-15 

REPORT, 8-15 

REPORTS, 8-16 

SORT, 8-16 

SORT PARAMETERS, 8-7 

SOURCE, 8-17 

STOI> 8-8 

USE, 8-8 
correcting data, 8-47 
creation of year-to-date reports, 8-43 
equating files, 8-47 
example of use, 8-2 
extended time period report 

from a FILEIODATA file, 8-43 

from a JOBSUMMARY file, 8-43 

from a STATISTICS file, 8-43 
file structure, 8-48 
files 

creation, 8-2 

FILEIODATA file, 8-2 

JOBSUMMARY file, 8-2 

LOGREPORTS 
use of REPORT command, 8-46 

STATISTICS file, 8-2 

YTDFILE 
file format, 8-44 
files used, 8-51 
input types, 8-3 
long-term report, 8-42 



options 

DEBUG, 8-5 

DRCONLY, 8-5 

RESETDRC, 8-5 

UPDATE, 8-5 

WRITEDRCDATA, 8-5 

WRITEIODATA, 8-5 

YEAR, 8-5 
organization, 8-48 
sources, 8-1 

suppressing program dumps, 8-47 
tables, 8-49 
logging 

monitoring logging of selected entries, 
10-1 

LOGGING (Logging Options) system 

command, 12-2 
<logname>, 7-3 
LOGOFFREASON data item 

LOGGER, 8-36 
LOGONREASON data item 

LOGGER, 8-36 
LOGREPORTS file 

LOGGER, 8-46, 8-53 
LOG ATTRIBUTE library object, 12-16 
LOG CLOSE library object, 12-17 
LOG GET library object, 12-17 
LOG OPEN library object, 12-18 
LOG READ library object, 12-18 
LOG SEEK library object, 12-19 
LOG SELECT library object, 12-19 
LOGSKIP library object, 12-22 
LSN data item 

LOGGER, 8-37 
<LSN>, 3-5 
LSNS option 

DCAUDITOR, 2-2 
LSI* (See line support processor (LSP)) 



M 

major types, 12-1 

MARC, (See Menu-Assisted Resource 

Control (MARC)) 
mark stack control word (MSCW), 4-86 
MASK command 

DUMPANALYZER, 4-78 
master control program (MCP), 4-1 
MAXJOBS data item 

LOGGER, 8-38 
MAXRECORDS command 
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LOGGER, 8-5 
MAXRECSIZE data item 

LOGGER, 8-40 
MAXTASKS data item 

LOGGER, 8-38 
MBYTEDAYS data item 

LOGGER, 8-42 
MCI* (See master control program (MCP)) 
MCPCODEFILE file 

DUMPANALYZER, 4-3 
MCP_LOGGER library object, 12-4 
MCPSUPPORT library 

and REPORTLOGENTRIES procedure, 
10-2 

and STATUSCHANGEREQUEST 
procedure, 11-2A 
MCS, (See message control system (MCS)) 
MCSLOGGER library object, 12-4 
MCSNAME data item 

LOGGER, 8-37 
MD command 

DUMPANALYZER, 4-80 
MEM command 

DUMPANALYZER, 4-81 
MEMINTCODE data item 

LOGGER, 8-37 
MEMINTDATA data item 

LOGGER, 8-37 
memory dump analysis, 4-1 
Menu-Assisted Resource Control (MARC), 
7-2 

message control system (MCS), 8-2 
Message Handling System (MHS) 

inLOGANALYZER, 7-14 

inSUMLOG, 12-294 
MESSAGES command 

DUMPANALYZER, 4-81 
< meta-item > , 4^60 
MHS, (See Message Handling System 
(MHS)) 

MHS option in LOGANALYZER, 7-14 
<MHS subtypes> in LOGANALYZER, 7-14 
minor types, 12-1 
MISCFILES data item 

LOGGER, 8-38 
MIX command 

DUMPANALYZER, 4-82 
<mix number > 

inLOGANALYZER, 7-16, 7-16B, 7-16C 

in LOGGER, 8-4 
MIXNO data item 

LOGGER, 8-37, 8-40 



MLS message entry 

SUMLOG, 12-278 
<mm/dd>, 8-4 
<mmddyy>, 8-8 
MODE command 

DUMPANALYZER, 4-83 
<mode option> 

MODE command, 4-83 

PV command, 4-104 
< modifier >, 3-1 
MONITOR directive 

peripheral test driver (PTD), 9-6 
MONITOR file 

format o£ 1-7 

in BARS, 1-7 
monitoring system performance 

BARS, 1-7 
monitoring system status 

STATUSCHANGEREQUEST 
procedure, 11-1 
MSCV^ (See mark stack control word 

(MSCW)) 
MSCW command 

DUMPANALYZER, 4-86 
multiple addresses 

DUMPANALYZER, 4-14 



N 

NAME data item 

LOGGER, 8-37 
NAMES command 

DUMPANALYZER, 4-87 
Network Management System (NMS) 

in LOGANALYZER, 7-14 

in SUMLOG, 12-294 
network support processor (NSP) 

DCSTATUS, 3-5 
network-independent software (NIS) 

in LOGANALYZER, 7-14 

in SUMLOG, 12-294 
NEWDISPLAY command 

BARS, 1-4 
NEWYTDFILE file 

LOGGER, 8-53 
NIS, (See network-independent software 
(NIS)) 

NIS option in LOGANALYZER, 7-14 
<NIS subtypes> in LOGANALYZER, 7-14 
NMS, (See Network Management System 
(NMS)) 
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NMS option in LOGANALYZER, 7-14 
<NMS subtypes> in LOGANALYZER, 7-14 
NONUSERFILES security option, 12-15 
NSP, (See network support processor 

(NSP)) 
NSP command 

DUMPANALYZER, 4-89 
NSP DOES NOT HAVE A TRACE TABLE 

message, 4-35 
<NSPunit ID>,2-1 
< number >, 4-10 



0 

< octal number >, 4-10 
<oddball field>, 4-19 

ODT, (See operator display terminal (ODT)) 
<offset>, 4-11 

BOXINFO command, 4-26 

PIB command, 4-97 

PV command, 4-104 

STACKWINDOW command, 4-123 

SUMMARY command, 4-127 
OL (Display Label and Paths) system 

command, 9-11 
<olayadd> 

DUMPANALYZER, 4-91 
OLAYINFO command 

DUMPANALYZER, 4-91 
Open System Interconnection (OSI) 
Directory 

in SUMLOG, 12-294 
Open Systems Interconnection (OSI) 

in LOGANALYZER, 7-14 

in SUMLOG, 12-294 
operating system 

memory dumps, analysis of, 4^1 
operator display terminal (ODT) 

input commands 
printing, 5-1 
saving, 5-1 

messages 
printing, 5-1 
saving, 5-1 
OPT command 

DUMPANALYZER, 4-91 
OPTION command 

LOGGER, 8-5 

to create year-to-date reports, 8-43 

< option list>, 7-3 
OPTIONS file 



DUMPANALYZER, 4-2 
ORGMCS data item 

LOGGER, 8-37 
ORGUNIT data item 

LOGGER, 8-37 
OSI, (See Open Systems Interconnection 
(OSI)) 

OSI option in LOGANALYZER, 7-14 
<OSI subtypes> in LOGANALYZER, 7-14 
OTHERPBITS data item 

LOGGER, 8-37 
OTHERPBITTIME data item 

LOGGER, 8-37 
OUTFELE file 

LOGGER, 8-52 
OUTPUT command 

LOGGER, 8-14 

< output options>, 7-21 

< output selection>, 4r-18 



P 

PACK command 

BARS, 1-5 
PACK data item 

LOGGER, 8-38 
PACKNAME data item 

LOGGER, 8-42 
PAGE SIZE command 

LOGGER, 8-15 
<partial word>, 4r-16 
Pascal 

analyzing heaps, 4-53 
PATHCNTRL command 

DUMPANALYZER, 4^93 
PATTERN command 

DUMPANALYZER, 4-95 
PC command 

DUMPANALYZER, 4-96 
TCW, (See program control word (PCW)) 
PERIOD command 

BARS, 1-5 
peripheral test driver (PTD), 9-1 

blocks, 9-1 

debugging test case code, 9-2 
directives, 9-4 

ACLOSE, 9-8 

AIIO, 9-8 

ALL, 9-9 

AOPEN, 9-8 

BCLOSE, 9-8 
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BIIO, 9-8 
BOJ, 9-8 
BOPEN, 9-8 
DISPLAY, 9-5 
DUM3 9-5 
EOJ, 9-9 
ERROR, 9-6 
GO, 9-7 

HELP IODEBUG, 9-8 
IODEBUG, 9-9 
IOSTOI* 9-9 
IOTRACE, 9-5 
large systems, 9-7 
LINES, 9-9 
MONITOR, 9-6 
PGMDUM3 9-6 
PRINT, 9-6 
QUIT, 9-7 
REPEAT, 9-7 
RUN, 9-7 
STATUS, 9-6 
TRACE, 9-6 
execution of, 9-1 

GS (group-separator character), use of, 
9-2 

operator interruption, 9-15 
PTD statement, 9-2 
PTDSPO file, 9-2 
sections, 9-1 

selecting test devices, 9-9 

test case example, 9-16 
PGMDUMP directive 

peripheral test driver (PTD), 9-6 
PIB, (See process information block (PIB)) 
<PIB cell name> 

PIB command, 4-97 

SUMMARY command, 4-127 
PIB command 

DUMPANALYZER, 4-97 
PINSTALLATION procedure, 12-7 
PORT command 

DUMPANALYZER, 4-99 
<port index >, 4^99 
PRINT directive 

peripheral test driver (PTD), 9-6 
PRINTARRAY command 

DUMPANALYZER, 4-100 
PRINTCODE command 

DUMPANALYZER, 4-96 
PRINTER command 

DUMPANALYZER, 4-101 
PRINTVAL command, (See PV command) 



PRIORITY data item 

LOGGER, 8-37 
PENT file 

LOGGER, 8-52 
process information block (PIB), 4-3 
PROCESSTIME data item 

LOGGER, 8-37 
PROCS command 

DUMPANALYZER, 4-102 
PROCSTACKS command 

DUMPANALYZER, 4-102 
program control word (PCW), 4-85 
program dumps 

using DUMPANALYZER to analyze, 4-9 
PROGRAMDUMP command 

DUMPANALYZER, 4-102 
pseudorecovery file 

DUMPANALYZER, 4-3 
PTD, (See peripheral test driver (PTD)) 
PTDSPO file 

peripheral test driver (PTD), 9-2 
public records 

and SDASUPPORT filtering, 12-21 

in LOGANALYZER 

and ACCESSCODE option, 7-18 

and CHARGECODE option, 7-18, 7-20 

in SUMLOG 

flag in log entry word 3, 12-1 1 
PUNCH data item 

LOGGER, 8-38 
P V command 

DUMPANALYZER, 4^104 
<PWI>, 4-96 



Q 

Q parameter 

of REPORTLOGENTRIES procedure, 
10-4 

format of messages, 10-6 
waiting for messages, 10-5 
of STATUSCHANGEREQUEST 
initializing, 11-3 
message format, 11-4 
waiting for messages, 1 1-4 
QINSERTEVENT queue attribute 

and REPORT LOG ENTRIES procedure, 
10-5 

and STATUS CHANGE REQUEST 
procedure, 11-4 
QUEUE command 
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DUMPANALYZER, 4-106 

QUEUE data item 
LOGGER, 8-37 

QUIT directive 

peripheral test driver (PTD), 9-7 

< quoted string> 

EXCLUDE command, 8-11 
HEADING command, 8-13 
INCLUDE command, 8-13 



R 

railroad diagrams, explanation of, A-l 
<range>, 2-1 
READER data item 

LOGGER, 8-38 
RECESS command 

DUMPANALYZER, 4-108 
REELNO data item 

LOGGER, 8-40 
< relative NSP number >, 4-35 
RELEASE command 

DUMPANALYZER, 4-108 
releasing system logs, 12-1 
RELX command 

DUMPANALYZER, 4-109 
REMOTE command 

DUMPANALYZER, 4-109 
REMOTE data item 

LOGGER, 8-38 
<rep spec>, 8-3 
REPEAT command 

DUMPANALYZER, 4-109 
REPEAT directive 

peripheral test driver (PTD), 9-7 
REPORT command 

LOGGER, 8-15 
report-specification commands 

LOGGER, 8-10 
REPORT_LOG_ENTRIES procedure, 10-1 

allocating an intercom queue, 10-4 

declaring in user program, 10-2 

detecting queue allocation errors, 10-5 

EXTRA parameter, 10-2 

INFO parameter, 10-2 

interpreting the log entries, 10-6 

procedure result, 10-5 

Q parameter 

initializing, 10-^1 
message format, 10-6 
waiting for messages, 10-5 



selecting log entry types, 10-2 
based on security relevance, 10-4 

user program requirements, 10-1 

VAL parameter 

enabling or disabling monitoring, 10-3 

waiting for log entries, 10-5 
REPORTS command 

LOGGER, 8-16 
RESULTQ command 

DUMPANALYZER, 4-110 
RETENTION data item 

LOGGER, 8-40 
RUN directive 

peripheral test driver (PTD), 9-7 



s 

SAVE ABORTED FOR DIRECT I/O ERROR 

error message, 4r-142 
SAVE ABORTED FOR INSUFFICIENT 

DISK SPACE error message, 4^142 
SAVE command 
BARS, 1-5 

DUMPANALYZER, 4-112 
SAVEFACTOR data item 

LOGGER, 8-40 
SBP (System Balancing Parameters) system 
command, 6-1 
INTERVAL parameter, 6-2 
IOINTERRUPT parameter, 6-2 
SCEVENTS parameter, of STATUS_ 

CHANGEREQUEST procedure, 

11- 2B 

SDASUPPORT library, 12-15 

LOG ATTRIBUTE library object, 12-16 
LOG_CLOSE library object, 12-17 
LOG GET library object, 12-17 
LOG OPEN library object, 12-18 
LOG READ library object, 12-18 
LOG SEEK library object, 12-19 
LOG SELECT library object, 12-19 
LOG SKIP library object, 12-22 
SDASUPPORTVERSION library object, 

12- 23 

SDASUPPORTVERSION library object, 

12-23 
SEARCH command 

DUMPANALYZER, 4H12 
<second parameter>, 4-116 
SECOPT (Security Options) system 
command, 7-20 
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NONUSERFILES security option, 12-15 

< section list >, 9-5 

< section numher>, 9-5 
security auditing 

and REP ORTLOGENTRIES procedure, 
10-1 

security mask field, in REPORT_LOG_ 

ENTRIES, 10-4 
SECURITYTYPE file attribute 
system log file, 12-15 

< selection options >, 7-6 
SERIALNO data item 

LOGGER, 8-40 
SESSIONS data item 

LOGGER, 8-38 
simple address 

DUMPANALYZER, 4-10 

< simple index list>, 4-15 
<simple location>, 4-10 

< simple value > 

DUMPANALYZER, 4-15 

multiple address, 4-14 

PV command, 4-104 

simple address, 4^10 
< simple word>, 4-15 
SITESUPPORT library, 12-7 
SITESUPPORT system library, 7-1 
SNA, (See Systems Network Architecture 
(SNA)) 

SNA option in LOGANALYZER, 7-14 
SORT command 

LOGGER, 8-16 
SORT PARAMETERS command 

LOGGER, 8-7 
<sort specs >, 4-127 
SOURCE command 

LOGGER, 8-17 
SSR, (See system stability reporting (SSR)) 
stability log, 13-1 
STABILITYLOG, 13-2 
<stack BASE cell name>, 4-10 
STACK command 

DUMPANALYZER, 4-116 
< stack ID>, 4-10 

< stack number > 

simple location, 4^10 
STACKWINDOW command, 4-123 

< stack offset >, 4^11 
<stack>,4-91 
STACKWINDOW command 

DUMPANALYZER, 4-123 
STANAME data item 



LOGGER, 8-37 
STARTTIME data item 

LOGGER, 8-37 
STATISTICS file 

file data items, 8-38 

LOGGER, 8-2, 8-52 
STATUS directive 

peripheral test driver (PTD), 9-6 
status monitoring 

STATUS_CHANGE_REQUEST 
procedure, 11-1 
STATUSCHANGEREQUEST procedure, 

11- 1 

allocating an intercom queue, 11-3 
declaring in user program, 1 1-2A 
detecting queue allocation errors, 1 1-4 
interpreting the event messages, 1 1-4 
procedure result, 11-4 
Q parameter 

initializing, 11-3 
message format, 11-4 
waiting for messages, 11-4 
SCEVENTS parameter, 11-2B 
selecting events for notification, 1 1-2B 
user program requirements, 11-2 
waiting for event messages, 1 1-4 

STOP command 

DUMPANALYZER, 4-124 
LOGGER, 8-8 

STOPTIME data item 
LOGGER, 8-37 

SUBPORT command 

DUMPANALYZER, 4-125 

SUMLOG, 12-1 

analysis by JOBFORMATTER, 12-7 
anonymous task and file accounting, 12-3 
changes in log entry formats, 12-14 
controlling log contents, 12-1 
customizing log analysis, 12-7 
defining installation log entries, 12-4 
DL (Disk Location) system command, 

12- 1 

first four words of log entries 

detailed format, 12-10 

overview, 12-9 
format of LINK words, 12-11 
format of log entries, 12-8 
LINK words, 12-11 
log analysis utilities, 12-6 
log entries 

general format, 12-9 
log entry types, 12-26 
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log structure, 12-8 
log title, 12-1 
maximum log size, 12-1 
MCPLOGGER library object, 12-4 
MCSLOGGER library object, 12^ 
monitoring logging of selected entries, 
10-1 

order of log entries, 12-11 

physical log records, 12-9 

read-only status, 12-4 

releasing logs, 12-1 

SDASUPPORT library, 12-15 

selective logging, 12-2 

configuration file copying, 12-3 

TL (Transfer Log) system command, 12-1 

WRITELOG procedure, 12-4 

writing log analysis programs, 12-8 
SUMMARY 

COREMAP command, 4-31 
SUMMARY command 

DUMPANALYZER, 4-127 
SUMMARY file 

LOGGER, 8-52 
< summary item>, 4-127 
supervisor programs 

and STATUSCHANGEREQUEST 
procedure, 11-1 
system balancing, 6-1 

dynamic variation of parameters, 6-1 

INTERVAL parameters, 6-2 

IOINTERRUPT parameters, 6-2 

usage o£ 6-3 

utilization of processing, 6-1 
<system serial number>, 7-5, 12-1 
system stability reporting (SSR), 13-1 
halt/load RSVP messages, 13-3 
ISTUTILITY, 13-4 

configuring halt review criteria, 13-14 

entering daily comments, 13-13 

initiating, 13-6 

installing, 13-4 

Main Menu screen, 13-7 

reviewing halt data, 13-8 

transfer schedule, 13-14 

using screens, 13-6 

viewing internal failure summaries, 
13-11 
stability log, 13-1 

location, 13-2 

structure and capacity, 13-2 
system status monitoring 



STATUS_CHANGE_REQUEST 
procedure, 11-1 
SYSTEM/STABILITYLOG, 13-2 
Systems Network Architecture (SNA) 

in SUMLOG, 12-294 



T 

TAB command 

DUMPANALYZER, 4-131 
TAPE data item 

LOGGER, 8-38 
TAPEIN file 

DUMPANALYZER, 4-2 
TASKS data item 

LOGGER, 8-38 
TCP/II* (See Transmission Control 
Protocol/Internet Protocol 
(TCP/IP)) 
TCPINFO command 

DUMPANALYZER, 4-134 
TCPIP option in LOGANALYZER, 7-14 
<TCPIP subtypes> in LOGANALYZER, 

7-14 
TEACH command 

BARS, 1-3 
TERMCOND data item 

LOGGER, 8-37 
TERMINAL command 

DUMPANALYZER, 4^136 
< terminal number >, 3-5 
TIME data item 

LOGGER, 8-38, 8-40 
<time> 

CORRECTION command, 8-4 

LOGANALYZER, 7-3 
TL (Transfer Log) system command, 12-1 

extended time period reports, 8—42 

LOGANALYZER, 7-5 

use with LOGGER, 8-1 
TR (Time Reset) system command, 12-11 
TRACE command 

DUMPANALYZER, 4-138 
TRACE directive, 9-6 
transfer schedule feature, of ISTUTILITY 

installing, 13-4 

scheduling transfers, 13-14 
Transmission Control Protocol/Internet 
Protocol (TCP/IP) 

in SUMLOG, 12-294, 12-302 
TYPE data item 
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LOGGER, 8-37 
<type>, 7-17 



u 

<unitID>, 3-5 
<unit number >, 7-8 
<unit spec>, 4-60 
< unit type >, 4-61 
UNITNO data item 

LOGGER, 8-40 
UNITS data item 

LOGGER, 8-41 
< until part> 

DUMPANALYZER, 4-14 
UPDATE option 

LOGGER, 8-5 
UR (Unit Reserved) system command, 9-10 
USAGE 

COREMAP command, 4-31 
USE command 

DUMPANALYZER, 4-140 

extended time period reports, 8-42 

LOGGER, 8-8 
USE data item 

LOGGER, 8-41 
USEDATE data item 

LOGGER, 8-42 
USERCODE data item 

LOGGER, 8-37, 8-41, 8-42 
<usercode> 
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